1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
|
from collections.abc import Sequence
from email.message import Message, MIMEPart
from email.mime.base import MIMEBase
from email.mime.message import MIMEMessage
from email.mime.multipart import MIMEMultipart
from email.mime.text import MIMEText
from email.utils import make_msgid as make_msgid
from typing import Any, NamedTuple, TypeAlias, overload
from django.utils.functional import _StrOrPromise
utf8_charset: Any
utf8_charset_qp: Any
DEFAULT_ATTACHMENT_MIME_TYPE: str
RFC5322_EMAIL_LINE_LENGTH_LIMIT: int
class BadHeaderError(ValueError): ...
ADDRESS_HEADERS: set[str]
def forbid_multi_line_headers(name: str, val: str, encoding: str) -> tuple[str, str]: ...
def sanitize_address(addr: tuple[str, str] | str, encoding: str) -> str: ...
class MIMEMixin:
def as_string(self, unixfrom: bool = False, linesep: str = "\n") -> str: ...
def as_bytes(self, unixfrom: bool = False, linesep: str = "\n") -> bytes: ...
class SafeMIMEMessage(MIMEMixin, MIMEMessage): ... # type: ignore[misc]
class SafeMIMEText(MIMEMixin, MIMEText): # type: ignore[misc]
encoding: str
def __init__(self, _text: str, _subtype: str = "plain", _charset: str | None = None) -> None: ...
class SafeMIMEMultipart(MIMEMixin, MIMEMultipart): # type: ignore[misc]
encoding: str
def __init__(
self,
_subtype: str = "mixed",
boundary: Any | None = None,
_subparts: Any | None = None,
encoding: str | None = None,
**_params: Any,
) -> None: ...
_AttachmentContent: TypeAlias = bytes | EmailMessage | Message | SafeMIMEText | str
_AttachmentTuple: TypeAlias = (
tuple[str, _AttachmentContent] | tuple[str | None, _AttachmentContent, str] | tuple[str, _AttachmentContent, None]
)
class EmailAlternative(NamedTuple):
content: _AttachmentContent
mimetype: str
class EmailAttachment(NamedTuple):
filename: str | None
content: _AttachmentContent
mimetype: str
class EmailMessage:
content_subtype: str
mixed_subtype: str
encoding: Any
to: list[str]
cc: list[Any]
bcc: list[Any]
reply_to: list[Any]
from_email: str
subject: _StrOrPromise
body: _StrOrPromise
attachments: list[Any]
extra_headers: dict[Any, Any]
connection: Any
def __init__(
self,
subject: _StrOrPromise = "",
body: _StrOrPromise | None = "",
from_email: str | None = None,
to: Sequence[str] | None = None,
bcc: Sequence[str] | None = None,
connection: Any | None = None,
attachments: Sequence[MIMEBase | _AttachmentTuple] | None = None,
headers: dict[str, str] | None = None,
cc: Sequence[str] | None = None,
reply_to: Sequence[str] | None = None,
) -> None: ...
def get_connection(self, fail_silently: bool = False) -> Any: ...
# TODO: when typeshed gets more types for email.Message, move it to MIMEMessage, now it has too many false-positives
def message(self) -> Any: ...
def recipients(self) -> list[str]: ...
def send(self, fail_silently: bool = False) -> int: ...
@overload
def attach(self, filename: MIMEBase | None = None, content: None = None, mimetype: None = None) -> None: ...
@overload
def attach(
self, filename: None = None, content: _AttachmentContent | None = None, mimetype: str | None = None
) -> None: ...
@overload
def attach(
self, filename: str | None = None, content: _AttachmentContent | None = None, mimetype: str | None = None
) -> None: ...
@overload
def attach(self, filename: MIMEPart) -> None: ...
def attach_file(self, path: str, mimetype: str | None = None) -> None: ...
class EmailMultiAlternatives(EmailMessage):
alternative_subtype: str
alternatives: list[tuple[_AttachmentContent, str]]
def __init__(
self,
subject: _StrOrPromise = "",
body: _StrOrPromise | None = "",
from_email: str | None = None,
to: Sequence[str] | None = None,
bcc: Sequence[str] | None = None,
connection: Any | None = None,
attachments: Sequence[MIMEBase | _AttachmentTuple] | None = None,
headers: dict[str, str] | None = None,
alternatives: list[tuple[_AttachmentContent, str]] | None = None,
cc: Sequence[str] | None = None,
reply_to: Sequence[str] | None = None,
) -> None: ...
def attach_alternative(self, content: _AttachmentContent, mimetype: str) -> None: ...
def body_contains(self, text: str) -> bool: ...
|
