Flesh out smtplib types further (#1558)

This fixes all current partial signatures, as well as adding anything
that I happened to have to work out whilst fixing those partial
signatures.

The stubs remain incomplete.

stdlib/3/smtplib.pyi

@@ -1,25 +1,30 @@
-from typing import Any
+from email.message import Message as _Message
+from typing import (
+    Any, AnyStr, Dict, Generic, List, Optional, Sequence, Tuple, Union)
+
+_Reply = Tuple[int, bytes]
+_SendErrs = Dict[str, _Reply]
 
 class SMTPException(OSError): ...
 class SMTPServerDisconnected(SMTPException): ...
 
 class SMTPResponseException(SMTPException):
-    smtp_code = ...  # type: Any
-    smtp_error = ...  # type: Any
-    args = ...  # type: Any
-    def __init__(self, code, msg) -> None: ...
+    smtp_code = ...  # type: int
+    smtp_error = ...  # type: Union[bytes, str]
+    args = ...  # type: Union[Tuple[int, Union[bytes, str]], Tuple[int, bytes, str]]
+    def __init__(self, code: int, msg: Union[bytes, str]) -> None: ...
 
 class SMTPSenderRefused(SMTPResponseException):
-    smtp_code = ...  # type: Any
-    smtp_error = ...  # type: Any
-    sender = ...  # type: Any
-    args = ...  # type: Any
-    def __init__(self, code, msg, sender) -> None: ...
+    smtp_code = ...  # type: int
+    smtp_error = ...  # type: bytes
+    sender = ...  # type: str
+    args = ...  # type: Tuple[int, bytes, str]
+    def __init__(self, code: int, msg: bytes, sender: str) -> None: ...
 
 class SMTPRecipientsRefused(SMTPException):
-    recipients = ...  # type: Any
-    args = ...  # type: Any
-    def __init__(self, recipients) -> None: ...
+    recipients = ...  # type: _SendErrs
+    args = ...  # type: Tuple[_SendErrs]
+    def __init__(self, recipients: _SendErrs) -> None: ...
 
 class SMTPDataError(SMTPResponseException): ...
 class SMTPConnectError(SMTPResponseException): ...
@@ -30,36 +35,37 @@ def quoteaddr(addrstring): ...
 def quotedata(data): ...
 
 class SMTP:
-    debuglevel = ...  # type: Any
+    debuglevel = ...  # type: int
     file = ...  # type: Any
     helo_resp = ...  # type: Any
     ehlo_msg = ...  # type: Any
     ehlo_resp = ...  # type: Any
     does_esmtp = ...  # type: Any
     default_port = ...  # type: Any
-    timeout = ...  # type: Any
+    timeout = ...  # type: float
     esmtp_features = ...  # type: Any
     source_address = ...  # type: Any
     local_hostname = ...  # type: Any
-    def __init__(self, host=..., port=..., local_hostname=..., timeout=...,
-                 source_address=...): ...
+    def __init__(self, host: str = ..., port: int = ...,
+                 local_hostname: Optional[str] = ..., timeout: float = ...,
+                 source_address: Tuple[str, int] = ...) -> None: ...
     def __enter__(self): ...
     def __exit__(self, *args): ...
-    def set_debuglevel(self, debuglevel): ...
+    def set_debuglevel(self, debuglevel: int) -> None: ...
     sock = ...  # type: Any
     def connect(self, host=..., port=..., source_address=...): ...
     def send(self, s): ...
     def putcmd(self, cmd, args=...): ...
-    def getreply(self): ...
+    def getreply(self) -> _Reply: ...
     def docmd(self, cmd, args=...): ...
     def helo(self, name=...): ...
     def ehlo(self, name=...): ...
     def has_extn(self, opt): ...
     def help(self, args=...): ...
-    def rset(self): ...
-    def noop(self): ...
-    def mail(self, sender, options=...): ...
-    def rcpt(self, recip, options=...): ...
+    def rset(self) -> _Reply: ...
+    def noop(self) -> _Reply: ...
+    def mail(self, sender: str, options: Sequence[str] = ...) -> _Reply: ...
+    def rcpt(self, recip: str, options: Sequence[str] = ...) -> _Reply: ...
     def data(self, msg): ...
     def verify(self, address): ...
     vrfy = ...  # type: Any
@@ -67,12 +73,15 @@ class SMTP:
     def ehlo_or_helo_if_needed(self): ...
     def login(self, user, password): ...
     def starttls(self, keyfile=..., certfile=..., context=...): ...
-    def sendmail(self, from_addr, to_addrs, msg, mail_options=...,
-                 rcpt_options=...): ...
-    def send_message(self, msg, from_addr=..., to_addrs=..., mail_options=...,
-                     rcpt_options=...): ...
+    def sendmail(self, from_addr: str, to_addrs: Union[str, Sequence[str]],
+                 msg: Union[bytes, str], mail_options: Sequence[str] = ...,
+                 rcpt_options: List[str] = ...) -> _SendErrs: ...
+    def send_message(self, msg: _Message, from_addr: Optional[str] = ...,
+                     to_addrs: Optional[Union[str, Sequence[str]]] = ...,
+                     mail_options: List[str] = ...,
+                     rcpt_options: Sequence[str] = ...) -> _SendErrs: ...
     def close(self): ...
-    def quit(self): ...
+    def quit(self) -> _Reply: ...
 
 class SMTP_SSL(SMTP):
     default_port = ...  # type: Any
@@ -84,7 +93,9 @@ class SMTP_SSL(SMTP):
 
 class LMTP(SMTP):
     ehlo_msg = ...  # type: Any
-    def __init__(self, host=..., port=..., local_hostname=..., source_address=...) -> None: ...
+    def __init__(self, host: str = ..., port: int = ...,
+                 local_hostname: Optional[str] = ...,
+                 source_address: Optional[Tuple[str, int]] = ...) -> None: ...
     sock = ...  # type: Any
     file = ...  # type: Any
     def connect(self, host=..., port=..., source_address=...): ...