mail: split out the SMTP login to allow the keyring extension to wrap it

The keyring extension only needs to tweak this tiny section of the larger
function.  But without any place to intercept the username/password fetching, it
copy/pasted the entire function, and has grown a bunch of compatibility hacks to
support older versions of Mercurial as well.

Differential Revision: https://phab.mercurial-scm.org/D10471

mercurial/mail.py

@@ -151,20 +151,9 b' def _smtp(ui):'
     if starttls or smtps:
         ui.note(_(b'(verifying remote certificate)\n'))
         sslutil.validatesocket(s.sock)
-    username = ui.config(b'smtp', b'username')
-    password = ui.config(b'smtp', b'password')
-    if username:
-        if password:
-            password = encoding.strfromlocal(password)
-        else:
-            password = ui.getpass()
-            if password is not None:
-                password = encoding.strfromlocal(password)
-    if username and password:
-        ui.note(_(b'(authenticating to mail server as %s)\n') % username)
-        username = encoding.strfromlocal(username)
+
         try:
-            s.login(username, password)
+        _smtp_login(ui, s, mailhost, mailport)
         except smtplib.SMTPException as inst:
             raise error.Abort(stringutil.forcebytestr(inst))
 
@@ -180,6 +169,29 b' def _smtp(ui):'
     return send
 
 
+def _smtp_login(ui, smtp, mailhost, mailport):
+    """A hook for the keyring extension to perform the actual SMTP login.
+
+    An already connected SMTP object of the proper type is provided, based on
+    the current configuration.  The host and port to which the connection was
+    established are provided for accessibility, since the SMTP object doesn't
+    provide an accessor.  ``smtplib.SMTPException`` is raised on error.
+    """
+    username = ui.config(b'smtp', b'username')
+    password = ui.config(b'smtp', b'password')
+    if username:
+        if password:
+            password = encoding.strfromlocal(password)
+        else:
+            password = ui.getpass()
+            if password is not None:
+                password = encoding.strfromlocal(password)
+    if username and password:
+        ui.note(_(b'(authenticating to mail server as %s)\n') % username)
+        username = encoding.strfromlocal(username)
+        smtp.login(username, password)
+
+
 def _sendmail(ui, sender, recipients, msg):
     '''send mail using sendmail.'''
     program = ui.config(b'email', b'method')