eletter 0.2.0

Installation

eletter requires Python 3.6 or higher. Just use pip for Python 3 (You have pip, right?) to install eletter and its dependencies:

python3 -m pip install eletter

Example

import eletter

TEXT = (
    "Oh my beloved!\n"
    "\n"
    "Wilt thou dine with me on the morrow?\n"
    "\n"
    "We're having hot pockets.\n"
    "\n"
    "Love, Me\n"
)

HTML = (
    "<p>Oh my beloved!</p>\n"
    "<p>Wilt thou dine with me on the morrow?</p>\n"
    "<p>We're having <strong>hot pockets</strong>.<p>\n"
    "<p><em>Love</em>, Me</p>\n"
)

with open("hot-pocket.png", "rb") as fp:
    picture = eletter.BytesAttachment(
        content=fp.read(),
        filename="enticement.png",
        content_type="image/png",
    )

msg = eletter.compose(
    subject="Meet Me",
    from_="me@here.qq",
    to=[eletter.Address("My Dear", "my.beloved@love.love")],
    text=TEXT,
    html=HTML,
    attachments=[picture],
)

# Now you can send `msg` like any other EmailMessage, say, by using
# outgoing <https://github/jwodder/outgoing>.

API

eletter.compose(
    subject: str,
    from_: Union[AnyAddress, Iterable[AnyAddress]],
    to: Iterable[AnyAddress],
    text: Optional[str] = None,
    html: Optional[str] = None,
    cc: Optional[Iterable[AnyAddress]] = None,
    bcc: Optional[Iterable[AnyAddress]] = None,
    reply_to: Optional[Union[AnyAddress, Iterable[AnyAddress]]] = None,
    sender: Optional[AnyAddress] = None,
    date: Optional[datetime.datetime] = None,
    attachments: Optional[Iterable[Attachment]] = None,
    headers: Optional[Mapping[str, Union[str, Iterable[str]]]] = None,
) -> email.message.EmailMessage

Construct an EmailMessage instance from a subject, “From:” address, “To:” value, and a plain text and/or HTML body, optionally accompanied by attachments and other headers.

Arguments:

subjectstring (required)

The e-mail’s “Subject:” line

from_address or iterable of addresses (required)

The e-mail’s “From:” line. Note that this argument is spelled with an underscore, as “from” is a keyword in Python.

toiterable of addresses (required)

The e-mail’s “To:” line

textstring

The contents of a text/plain body for the e-mail. At least one of text and html must be specified.

htmlstring

The contents of a text/html body for the e-mail. At least one of text and html must be specified.

cciterable of addresses (optional)

The e-mail’s “CC:” line

bcciterable of addresses (optional)

The e-mail’s “BCC:” line

reply_toaddress or iterable of addresses (optional)

The e-mail’s “Reply-To:” line

senderaddress (optional)

The e-mail’s “Sender:” line. The address must be a string or Address, not a Group.

datedatetime (optional)

The e-mail’s “Date:” line

attachmentsiterable of attachments (optional)

A collection of attachments (see “Attachments”) to append to the e-mail

headersmapping from header names to strings or iterables of strings (optional)

A collection of additional headers to add to the e-mail. A header value may be either a single string or an iterable of strings to add multiple headers with the same name. If you wish to set an otherwise-unsupported address header like Resent-From to a list of addresses, use the format_addresses() function to first convert the addresses to a string.

eletter.BytesAttachment(
    content: bytes,
    filename: str,
    *,
    content_type: str = "application/octet-stream",
    inline: bool = False,
)

@classmethod
eletter.BytesAttachment.from_file(
    cls,
    path: Union[bytes, str, os.PathLike],
    content_type: Optional[str] = None,
) -> BytesAttachment

eletter.TextAttachment(
    content: str,
    filename: str,
    *,
    content_type: str = "text/plain",
    inline: bool = False,
)

@classmethod
eletter.TextAttachment.from_file(
    cls,
    path: Union[bytes, str, os.PathLike],
    content_type: Optional[str] = None,
    encoding: Optional[str] = None,
    errors: Optional[str] = None,
) -> TextAttachment

eletter.EmailAttachment(
    content: email.message.EmailMessage,
    filename: str,
    *,
    inline: bool = False,
)

@classmethod
eletter.EmailAttachment.from_file(
    cls,
    path: Union[bytes, str, os.PathLike],
) -> EmailAttachment

eletter.assemble_content_type(maintype: str, subtype: str, **params: str) -> str

eletter.format_addresses(addresses: Iterable[AnyAddress]) -> str

eletter.reply_quote(s: str, prefix: str = "> ") -> str