用Python發一封圖文並茂的郵件

時間 2020-05-22

原文原文鏈接

最近使用了很多通信工具的接口, 好比企業微信機器人，釘釘，微信公衆號的接口(未認證的訂閱公衆號)，相對於郵件來講，它們的表現形式太弱。好比沒有更豐富的版本方式。固然了，並非說表現形式越棒就是約好的通知手段，這個依我的狀況而定，而我偏偏須要比較豐富的表現形式，最終仍是回到了郵件，郵件真香!css

而我的微信號的接口我沒有合適的微信號能夠登陸，若是網頁版微信沒有被封的話，我想這個是表現形式與消息時效性結合的最好的方式。html

環境

雖然說就發郵件這麼個小事，很容易兼容Python2, Python3, 可是你們仍是擁抱Python3吧, 我這裏沒有作python2的兼容寫法，因此須要python3以上。python

郵件的格式

郵件的格式主要就兩種: plain和htmlgit

plain就像一個普通的文本, 沒有格式。github

html就如其名, 是html的格式，至關於一個郵件就是一個靜態的網頁，這樣的話可玩性就很高了，你能夠經過css控制表現形式.web

注意: 這裏的css雖然語法同樣，但，是否與瀏覽器渲染結果徹底一致, 是不必定的。瀏覽器

那麼可能有人要問了，我要發一個動態的網頁怎麼辦? 發個連接呀服務器

郵箱帳號

不管是QQ郵箱抑或網易郵箱都是沒有問題的，重要的是有一個能夠經過smtp服務器發送郵件的帳戶名及密碼，這裏你們百度吧。微信

發送郵件的代碼

由於發送郵件的代碼在下面每一個步驟都是同樣的因此線貼出來app

def send_email(msg, mail_to, smtp_host, smtp_username, smtp_password, subject, from_):
    msg["Subject"] = Header(subject, "utf-8")
    msg["From"] = Header(from_, "utf-8")
    if not isinstance(mail_to, list):
        mail_to = [mail_to]
    msg["To"] = COMMASPACE.join(mail_to)

    try:
        print("準備鏈接smtp郵件服務器: %s" % smtp_host)
        client = smtplib.SMTP(smtp_host)
        print("鏈接成功")
        # client = smtplib.SMTP("localhost")
        # client.set_debuglevel(1)
        # print(self.mail_user, self.mail_pass)
        client.login(smtp_username, smtp_password)
        print("登陸成功")
        # print("=====>", self.mail_from, mail_to)
        print("經過郵箱[%s]發送郵件給 %s" % (smtp_username, COMMASPACE.join(mail_to)))
        client.sendmail(smtp_username, mail_to, msg.as_string())
        print("發送成功...")
        return True
    except Exception:
        print("發送郵件失敗")
    finally:
        client.quit()

若是遇到郵件發送的問題能夠將client.set_debuglevel(1)的註釋取消，這樣會顯示足夠多的debug信息用於排查問題。

發送本地圖片

這裏發送圖片的意思是指, 圖片內嵌在郵件中而不是以附件的形式出現。

效果以下:

代碼以下:

EMAIL_IMAGE_TEMPLATE = """<html>
<head>
<title>Page Title</title>
</head>
<body>
<h3>這是一張圖片</h3>
<p><img src="cid:{{image_name}}" height="112" width="200" ></p>
</body>
</html>
"""

def create_image_eamil_contant(fp):
    tpl = Template(EMAIL_IMAGE_TEMPLATE)
    if not path.exists(fp):
        sys.exit("要發送的本地圖片不存在")

    msg = MIMEMultipart("related")
    image_name = "demo"

    with open(fp, "rb") as rf:
        mime_image = MIMEImage(rf.read())
        # 注意: 必定須要<>括號
        mime_image.add_header("Content-ID", "<%s>" % image_name)
        msg.attach(mime_image)

    # 渲染郵件文本內容
    text = tpl.render(image_name=image_name)
    msg_alternative = MIMEMultipart("alternative")
    msg_alternative.attach(MIMEText(text, "html", "utf-8"))

    msg.attach(msg_alternative)

    return msg

若是你使用過python的web框架，你對文本的渲染必定不陌生，由於大多數web框架都支持文本渲染，這裏使用的jinja2.

發送程序生成的照片

其實這裏跟上面沒什麼區別的，惟一的區別就是是否保存在本地，既然能發送本地圖片，我就先保存到本地而後再按照上面的方式不久能夠了麼? 首先這個方法是沒有問題的，不過多了一次IO, 能在內存中解決的事爲何要放到本地呢？

這種狀況主要是應對回去圖片的方式是從其餘接口獲取到的，或者實時生成的時候。雖然很簡單，但以爲說說也挺有意思的。

這裏的模擬方式是假設在網上獲取到了多張base64編碼的圖片，須要將其組合在一塊兒，而後在不保存在本地狀況下直接發送這張照片。

這個base64編碼的圖片已經保存在本地了，名字是demo_base64.txt

效果以下:

代碼以下:

EMAIL_ONLINE_IMAGE_TEMPLATE = """<html>
<head>
<title>Page Title</title>
</head>
<body>
<h3>這是一張圖片</h3>
<p><img src="cid:{{image_name}}" ></p>
</body>
</html>
"""

def create_online_image_content():
    from PIL import Image

    tpl = Template(EMAIL_ONLINE_IMAGE_TEMPLATE)
    fp = "demo_base64.txt"
    if not path.exists(fp):
        sys.exit("要發送的base64編碼的圖片不存在")

    msg = MIMEMultipart("related")
    image_name = "demo"

    with open(fp, "rb") as rf:
        base64_data = rf.read()
        img_data = base64.b64decode(base64_data)
        # 由於open方法須要一個file-like文件對象，而咱們解碼後的對象類型是bytes類型
        # bytes類型沒有文件對象的read, close方法，因此咱們須要經過BytesIO對象包裝一下，它會返回一個file-like文件對象
        img = Image.open(BytesIO(img_data))
        img_width, img_height = img.size

        repeat_times = 5
        # compose images
        ret_img  = Image.new(img.mode, (img_width, img_height * repeat_times))
        for index in range(repeat_times):
            ret_img.paste(img, box=(0, index * img_height))

        # 由於MIMEImage須要一個bytes對象，因此們須要獲取圖片編碼後的二進制數據而不是圖片的array數據
        img_bytes = BytesIO()
        # 若是不指定圖片格式，會由於沒有文件名而報錯
        ret_img.save(img_bytes, "png")

        mime_image = MIMEImage(img_bytes.getvalue())
        # 注意: 必定須要<>括號
        mime_image.add_header("Content-ID", "<%s>" % image_name)
        msg.attach(mime_image)

    # 渲染郵件文本內容
    text = tpl.render(image_name=image_name)
    msg_alternative = MIMEMultipart("alternative")
    msg_alternative.attach(MIMEText(text, "html", "utf-8"))

    msg.attach(msg_alternative)

    return msg

這裏頗有意思一點是用BytesIO模擬file-like對象。這裏須要安裝PIL哦

發送一個帶樣式的靜態網頁

前面的代碼已經足夠說明圖片怎麼發了，這裏經過一個寫了css樣式的表格進行演示

效果以下:

代碼以下:

EMAIL_TEMPLATE = """<html>
<head>
    <style type="text/css">
        table
        {
            border-collapse: collapse;
            margin: 0 auto;
            text-align: center;
        }

        table td, table th
        {
            border: 1px solid #cad9ea;
            color: #666;
            height: 30px;
        }

        table thead th
        {
            background-color: #CCE8EB;
            width: 100px;
        }

        table tr:nth-child(odd)
        {
            background: #fff;
        }

        table tr:nth-child(even)
        {
            background: #F5FAFA;
        }
    </style> 
</head>
<body>
<p>一共有如下{{record_size}}條數據</p>
<table width="90%" class="table">
    <thead>
        <tr>
        {% for label in labels %}
            <th>{{label}}</th>
        {% endfor %}
        </tr>
    </thead>
    <tbody>
{% for item in items %}
    <tr>
    {% for value in item %}
        <td>{{value}}</td>
    {% endfor %}
    </tr>
{% endfor %}
    </tbody>
</table>
</html>"""

def create_html_content():
    tpl = Template(EMAIL_TEMPLATE)

    record_size = 10
    label_size = 5
    labels = ["label-%s" % i for i in range(label_size)]
    items = []

    for _ in range(record_size):
        item = ["item-%s" % value_index for value_index in range(label_size)]
        items.append(item)

    text = tpl.render(record_size=record_size, items=items, labels=labels)
    msg = MIMEText(text, "html", "utf-8")
    return msg