From da77cfaf5e6b6182eb31ff2b6510d8dfacb5134c Mon Sep 17 00:00:00 2001 From: "Erlend E. Aasland" Date: Sun, 21 Jan 2024 12:27:33 +0100 Subject: [PATCH] Docs: mark up FTP() constructor with param list (GH-114359) (cherry picked from commit 96c15b1c8d03db5b7b5b719214d9d156b317ba9d) Co-authored-by: Erlend E. Aasland Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com> --- Doc/library/ftplib.rst | 43 +++++++++++++++++++++++++++++++++--------- 1 file changed, 34 insertions(+), 9 deletions(-) diff --git a/Doc/library/ftplib.rst b/Doc/library/ftplib.rst index e4b696c1e4e9d3..07100d42520b26 100644 --- a/Doc/library/ftplib.rst +++ b/Doc/library/ftplib.rst @@ -58,15 +58,40 @@ FTP objects .. class:: FTP(host='', user='', passwd='', acct='', timeout=None, \ source_address=None, *, encoding='utf-8') - Return a new instance of the :class:`FTP` class. When *host* is given, the - method call ``connect(host)`` is made. When *user* is given, additionally - the method call ``login(user, passwd, acct)`` is made (where *passwd* and - *acct* default to the empty string when not given). The optional *timeout* - parameter specifies a timeout in seconds for blocking operations like the - connection attempt (if is not specified, the global default timeout setting - will be used). *source_address* is a 2-tuple ``(host, port)`` for the socket - to bind to as its source address before connecting. The *encoding* parameter - specifies the encoding for directories and filenames. + Return a new instance of the :class:`FTP` class. + When *host* is given, the method call :meth:`connect(host) ` + is made by the constructor. + When *user* is given, additionally the method call + :meth:`login(user, passwd, acct) ` is made. + + :param str host: + The hostname to connect to. + + :param str user: + The username to log in with. + If empty string, ``"anonymous"`` is used. + + :param str passwd: + The password to use when logging in. + If not given, and if *passwd* is the empty string or ``"-"``, + a password will be automatically generated. + + :param str acct: + Account information; see the ACCT FTP command. + + :param timeout: + A timeout in seconds for blocking operations like :meth:`connect`. + If not specified, the global default timeout setting will be used. + :type timeout: int | None + + :param source_address: + *source_address* is a 2-tuple ``(host, port)`` for the socket + to bind to as its source address before connecting. + :type source_address: tuple | None + + :param str encoding: + The *encoding* parameter specifies the encoding + for directories and filenames. The :class:`FTP` class supports the :keyword:`with` statement, e.g.: