Bootstrap

Python 从0到1手搓邮件发送客户端软件

Python 从0到1手搓邮件发送客户端软件

相关资源文件已经打包成EXE文件,可双击直接运行程序,且文章末尾已附上相关源码,以供大家学习交流,博主主页还有更多Python相关程序案例,秉着开源精神的想法,望大家喜欢,点个关注不迷路!!!

1. 简介:

这款邮件发送客户端是一款桌面应用程序,旨在提供一个简洁且高效的邮件发送界面,支持发送邮件、附件、定时发送以及个性化邮件正文。该应用支持通过SMTP协议发送电子邮件,提供丰富的配置选项,并支持附件管理。它还允许用户设置邮件签名,支持拖拽文件添加附件,能够根据用户设定的时间进行邮件的定时发送。界面设计采用了浅蓝色主题,用户体验友好。

2.主要功能:

2.1.邮件发送功能:

  • 输入邮件账号、授权码、SMTP服务器、端口等信息。
  • 填写邮件收件人、抄送人、邮件标题和正文。
  • 支持富文本格式邮件正文(支持HTML和图片)。
  • 可以添加附件,并在邮件中附加多个文件。
  • 用户点击发送邮件按钮时,send_email 函数会读取用户输入的邮件信息(账号、密码、SMTP信息等),创建一个 MIME
    格式的邮件对象。邮件正文以 HTML 格式发送,并添加附件(如果有)。
  • 通过 smtplib.SMTP_SSL 连接到SMTP服务器,并使用提供的邮件账号和授权码登录,最后将邮件发送出去。

2.2.个性签名功能:

允许用户设置邮件的个性签名,支持HTML和图片:通过 signature_input 支持富文本,用户可以在其中插入HTML标签(包括 标签)。在发送邮件时,如果个性签名包含图片,这些图片会被作为附件嵌入到邮件中。

2.3.定时发送功能:

  • 用户可以设置定时发送邮件的时间。schedule_email_send
    函数会根据当前时间和设定的时间差,利用定时器(QTimer)在指定时间调用 send_email 函数发送邮件。
  • 为了支持定时发送邮件功能,需要在现有代码中添加一个定时器,允许用户设定发送时间,并在设定的时间自动发送邮件。我们可以通过 QTimer 来实现定时功能。定时发送部分:
  • 新增了 QDateTimeEdit 输入框,允许用户选择定时发送的日期和时间。
  • 新增了一个 schedule_email_send() 函数,用来计算当前时间与目标发送时间的差距,并通过
    QTimer.singleShot() 在设定的时间触发邮件发送。
  • 定时发送邮件 按钮将调用 schedule_email_send() 函数。

相关定时器的实现:

  • 使用 QTimer.singleShot() 来定时触发邮件发送。该函数接收时间间隔(以毫秒为单位)和要执行的回调函数(即send_email())。

2. 4.附件管理:

  • 支持通过文件选择框或者拖拽文件添加附件。

  • 显示附件名称和文件大小。

  • 支持清除附件功能。

  • 一键多选附件:

  • 附件添加:通过 add_attachment
    函数,用户可以通过文件对话框选择一个或多个文件,添加到附件列表,并在表格中显示文件名和文件大小。

  • 附件清除:通过 clear_attachments 函数,用户可以清空附件列表。

  • 附件表格:attachment_table 用于显示附件信息,每个附件占一行,显示文件名和大小。

  • 使用filedialog.askopenfilenames(),允许用户选择多个文件。
    选择的每个文件的名称、路径和文件大小被添加到附件列表中。

  • 使用tkinterdnd2库实现拖拽文件到程序中。 当文件被拖拽到窗口时,会显示附件的名称和文件大小。

2.5.配置加载功能:

  • 应用启动时,load_config 函数会检查当前路径是否存在 config.ini文件,如果存在,将从文件中读取邮件账号、授权码、SMTP服务器及端口,并自动填充输入框,且设置为只读。

  • 配置文件格式 (config.ini): config.ini文件应包含如下内容:

sender_email:邮件账号。
sender_password:授权码。
smtp_server:SMTP服务器地址。
smtp_port:SMTP服务器端口号。

[Email]
sender_email = your_email@example.com
sender_password = your_authorization_code

[SMTP]
smtp_server = smtp.example.com
smtp_port = 465
  • 自动加载当前路径配置文件(config.ini),填充发件人的邮件账号、授权码等字段信息,并设置为只读。

2.6.主题设置和UI:

  • 使用 QVBoxLayout 和 QHBoxLayout 布局管理器,组织各个控件的排版。
  • 使用 QPalette 设置浅蓝色背景、按钮背景和输入框背景等颜色,并定义按钮文本为白色,使用 Segoe UI 字体。

2.7.错误处理与消息框:

  • 在遇到错误(如SMTP连接失败、配置文件读取失败等)时,使用 QMessageBox 弹出提示框显示错误信息。

2.8 日志保存功能:

  • 在当前路径生成 email_send.log日志文件,保存相关邮件发送信息等事件。

3. 运行效果:

普通界面:

在这里插入图片描述

**

UI美化界面:

**
在这里插入图片描述

**

发送成功界面:

**
在这里插入图片描述

**

邮箱接收界面:

**

在这里插入图片描述

**

日志生成页面:

**
在这里插入图片描述
**

资源列表页面:

**

在这里插入图片描述

4.BUG修复之路:

4.1 显示发送邮件失败,软件报错:getaddrinfo faied

  • 后面检查发现是邮件服务器填写时候多敲了一个空格导致的报错,后面在发送邮件时,在send_email函数中,使用.strip()方法去除输入框内容的首尾空格和TAB字符。
  • 邮件正文通过body_text.get(“1.0”, tk.END).strip()获取内容时,也会清除多余的空格和TAB字符。

4.2 附件发送比如.xlsx发出去变成未命名.bin文件

  • 当发送 .xlsx 等 Office 类型附件时,附件变成 .bin 文件的原因,通常是因为邮件的 MIME类型没有正确指定,导致邮件客户端无法识别文件类型并将其处理为二进制流。因此,需要确保在附件添加时指定正确的 MIME 类型和内容类型。
  • 对于 .xlsx 文件,我们需要确保 MIME 类型设置为application/vnd.openxmlformats-officedocument.spreadsheetml.sheet。同样,其他Office 文件(如 .docx、.pptx)也有各自的 MIME 类型。

修改代码:正确设置 MIME 类型
我们可以修改附件的 MIME 类型来确保文件以原格式发送。以下是如何修复这个问题:

  • 针对 Office 文件设置正确的 MIME 类型
  • 根据附件的扩展名自动设置 MIME 类型

主要修改:

  • 使用 mimetypes 识别文件类型:通过 mimetypes.guess_type() 函数识别文件的 MIME
    类型。如果文件类型是已知的(例如 .xlsx),就会设置正确的 MIME 类型。

  • create_attachment 函数:这个函数根据文件类型创建附件并设置适当的 MIME 类型。如果是 .xlsx 文件,则设置
    application/vnd.openxmlformats-officedocument.spreadsheetml.sheet MIME 类型。

5.总结:

总之这个邮件客户端不仅提供基础的邮件发送和附件管理功能,还集成了定时发送、个性签名等高级功能,兼具简洁的用户界面和较强的功能扩展性。界面采用简洁明了的浅蓝色主题,结合了现代UI设计理念和丰富的邮件配置选项,适合用户进行邮件发送和管理

4. 部分相关源码分享:

完整源码以及打包好的exe程序文件等都放在压缩包了哦,有需要的可以点击下载:https://download.csdn.net/download/Clay_K/90289760

# 读取config.ini文件并填充输入框
def load_config():
    config_file = "config.ini"
    if os.path.exists(config_file):
        config = configparser.ConfigParser()
        config.read(config_file)
        
        try:
            sender_email = config.get("Email", "sender_email")
            sender_password = config.get("Email", "sender_password")
            smtp_server = config.get("SMTP", "smtp_server")
            smtp_port = config.get("SMTP", "smtp_port")
            
            # 填充输入框并设置为只读
            sender_email_input.setText(sender_email)
            sender_password_input.setText(sender_password)
            smtp_server_input.setText(smtp_server)
            smtp_port_input.setText(smtp_port)
            
            # 设置输入框为只读
            sender_email_input.setReadOnly(True)
            sender_password_input.setReadOnly(True)
            smtp_server_input.setReadOnly(True)
            smtp_port_input.setReadOnly(True)
            
        except Exception as e:
            QMessageBox.critical(window, "错误", f"读取配置文件失败: {e}")
    else:
        # 如果没有config.ini文件,不做任何操作
        pass

# 发送邮件的函数
def send_email():
    sender_email = sender_email_input.text().strip()
    sender_password = sender_password_input.text().strip()
    smtp_server = smtp_server_input.text().strip()
    smtp_port = smtp_port_input.text().strip()
    recipient_email = recipient_input.text().strip()
    cc_email = cc_input.text().strip().replace(";", ",")  # 替换中文分隔符
    subject = subject_input.text().strip()
    body = body_input.toPlainText().strip()
    signature = signature_input.toHtml().strip()  # 获取个性签名HTML内容

    # 将个性签名添加到邮件正文
    if signature:
        body += f"<br><br>{signature}"

    # 检查SMTP端口是否有效
    if not smtp_port.isdigit():
        QMessageBox.critical(window, "错误", "请输入有效的SMTP端口号!")
        return

    # 创建邮件
    msg = MIMEMultipart("related")  # 允许邮件中包含HTML内容和附件
    msg['From'] = sender_email
    msg['To'] = recipient_email
    if cc_email:
        msg['Cc'] = cc_email  # 抄送多个邮箱
    msg['Subject'] = subject

    # 邮件正文
    msg_html = MIMEText(body, 'html', 'utf-8')  # 使用HTML格式发送邮件正文
    msg.attach(msg_html)

    # 添加附件
    for file in attachments:
        file_path = file['path']
        file_name = file['name']
        mime_type, _ = mimetypes.guess_type(file_path)  # 根据文件扩展名自动猜测 MIME 类型
        if mime_type is None:
            mime_type = 'application/octet-stream'  # 默认 MIME 类型
        
        main_type, sub_type = mime_type.split('/')
        part = MIMEBase(main_type, sub_type)
        with open(file_path, 'rb') as f:
            part.set_payload(f.read())
        encoders.encode_base64(part)
        part.add_header('Content-Disposition', f'attachment; filename="{file_name}"')
        msg.attach(part)

    try:
        # 设置SMTP服务器
        with smtplib.SMTP_SSL(smtp_server, int(smtp_port)) as server:
            server.login(sender_email, sender_password)
            # 发送邮件
            server.sendmail(sender_email, [recipient_email] + (cc_email.split(',') if cc_email else []), msg.as_string())
        
        QMessageBox.information(window, "成功", "邮件发送成功!")
        #clear_fields()  # 发送邮件后清除输入框和附件
    except Exception as e:
        QMessageBox.critical(window, "错误", f"发送邮件失败: {e}")

# 添加附件的函数
def add_attachment():
    file_paths, _ = QFileDialog.getOpenFileNames(window, "选择附件", "", "All Files (*);;Text Files (*.txt);;Image Files (*.png *.jpg *.bmp);;Excel Files (*.xlsx);;PDF Files (*.pdf)")
    if file_paths:
        for file_path in file_paths:
            file_name = os.path.basename(file_path)
            file_size = os.path.getsize(file_path)
            attachments.append({"name": file_name, "path": file_path, "size": file_size})
            # 将附件信息添加到表格中
            row_position = attachment_table.rowCount()
            attachment_table.insertRow(row_position)
            attachment_table.setItem(row_position, 0, QTableWidgetItem(file_name))
            attachment_table.setItem(row_position, 1, QTableWidgetItem(f"{file_size // 1024} KB"))

# 清除附件的函数
def clear_attachments():
    attachments.clear()
    attachment_table.setRowCount(0)

# 清除所有输入框的内容和附件
def clear_fields():
    sender_email_input.clear()
    sender_password_input.clear()
    smtp_server_input.clear()
    smtp_port_input.clear()
    recipient_input.clear()
    cc_input.clear()
    subject_input.clear()
    body_input.clear()
    signature_input.clear()  # 清除个性签名输入框内容
    clear_attachments()  # 清除附件列表

# 设置定时发送的函数
def schedule_email_send():
    send_time = send_time_input.dateTime()
    current_time = QDateTime.currentDateTime()
    
    if send_time <= current_time:
        QMessageBox.critical(window, "错误", "请选择未来的时间!")
        return
    
    time_diff = current_time.msecsTo(send_time)  # 计算定时发送的时间差
    timer.singleShot(time_diff, send_email)  # 定时调用发送邮件函数
    QMessageBox.information(window, "成功", f"邮件将在 {send_time.toString()} 发送。")

# 创建主窗口
app = QApplication(sys.argv)
window = QWidget()
window.setWindowTitle("邮件发送客户端")
window.setWindowIcon(QIcon("icon.png"))  # 可以设置一个图标
window.setGeometry(100, 100, 400, 700)  # 增加窗口高度,以适应新添加的个性签名文本框

# 创建浅蓝色主题
def set_light_blue_theme():
    palette = QPalette()
    palette.setColor(QPalette.Background, QColor(173, 216, 230))  # 浅蓝色背景
    palette.setColor(QPalette.WindowText, QColor(0, 0, 0))  # 黑色文本
    palette.setColor(QPalette.Button, QColor(73, 170, 160))  # 按钮背景色为 #49AAA0
    palette.setColor(QPalette.ButtonText, QColor(255, 255, 255))  # 按钮文本为白色
    palette.setColor(QPalette.Base, QColor(240, 248, 255))  # 浅蓝色输入框背景
    palette.setColor(QPalette.Text, QColor(0, 0, 0))  # 黑色文本
    window.setPalette(palette)

set_light_blue_theme()

# 设置字体为 Segoe UI
font = QFont("Segoe UI", 10)
window.setFont(font)
;