summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMiss Islington (bot) <31488909+miss-islington@users.noreply.github.com>2018-09-10 11:16:11 -0700
committerGitHub <noreply@github.com>2018-09-10 11:16:11 -0700
commitc0db8177dc9a7f79941551576e1faea9724e027d (patch)
treefb22dbee3d10a222fe2de1292d4970662ee1cc1e
parent[3.6] Fix misleading mentions of tp_size in comments (GH-9137) (diff)
downloadcpython-c0db8177dc9a7f79941551576e1faea9724e027d.tar.gz
cpython-c0db8177dc9a7f79941551576e1faea9724e027d.tar.bz2
cpython-c0db8177dc9a7f79941551576e1faea9724e027d.zip
closes bpo-34525: Fix smtplib's authobject() documentation (GH-8965)
(cherry picked from commit 78deb7f33227972987722bc3fed5bcb45fae869e) Co-authored-by: Sebastian Rittau <srittau@rittau.org>
-rw-r--r--Doc/library/smtplib.rst4
-rwxr-xr-xLib/smtplib.py2
2 files changed, 3 insertions, 3 deletions
diff --git a/Doc/library/smtplib.rst b/Doc/library/smtplib.rst
index 805217252ae..6fb0934218a 100644
--- a/Doc/library/smtplib.rst
+++ b/Doc/library/smtplib.rst
@@ -346,7 +346,7 @@ An :class:`SMTP` instance has the following methods:
If optional keyword argument *initial_response_ok* is true,
``authobject()`` will be called first with no argument. It can return the
- :rfc:`4954` "initial response" bytes which will be encoded and sent with
+ :rfc:`4954` "initial response" ASCII ``str`` which will be encoded and sent with
the ``AUTH`` command as below. If the ``authobject()`` does not support an
initial response (e.g. because it requires a challenge), it should return
``None`` when called with ``challenge=None``. If *initial_response_ok* is
@@ -355,7 +355,7 @@ An :class:`SMTP` instance has the following methods:
If the initial response check returns ``None``, or if *initial_response_ok* is
false, ``authobject()`` will be called to process the server's challenge
response; the *challenge* argument it is passed will be a ``bytes``. It
- should return ``bytes`` *data* that will be base64 encoded and sent to the
+ should return ASCII ``str`` *data* that will be base64 encoded and sent to the
server.
The ``SMTP`` class provides ``authobjects`` for the ``CRAM-MD5``, ``PLAIN``,
diff --git a/Lib/smtplib.py b/Lib/smtplib.py
index 048c6bfb067..5e1bc0b198e 100755
--- a/Lib/smtplib.py
+++ b/Lib/smtplib.py
@@ -615,7 +615,7 @@ class SMTP:
It will be called to process the server's challenge response; the
challenge argument it is passed will be a bytes. It should return
- bytes data that will be base64 encoded and sent to the server.
+ an ASCII string that will be base64 encoded and sent to the server.
Keyword arguments:
- initial_response_ok: Allow sending the RFC 4954 initial-response