Привет всем! Меня зовут Дмитрий. Я надеюсь, что статья будет полезной и интересной для вас (не пинайте сильно, первый опыт, мысли путаются). Тема моей статьи — создание веб-приложения на Python Flask для автоматизации выдачи сертификатов и вдохновился написанием ее после прочтения Почта без хлопот: автоматизация отправки писем с помощью Python
В современном мире всё больше процессов автоматизируется, чтобы упростить жизнь людей и сократить время на выполнение рутинных задач. Одной из таких задач является выдача сертификатов. Раньше в организации где я работаю они выдавались в бумажном виде, но с приходом COVID-19 когда ушли на дистант, и все курсы были дистанционно я решил написать сначала скрипт, а потом и полноценное приложение с веб интерфейсом для рассылки сертификатов.
В этой статье я расскажу о процессе создания веб-приложения на Python/Flask, которое будет использоваться для автоматизации процесса выдачи сертификатов. Расписывать все основы я не буду поэтому перейдем с разу к делу, походу буду комментировать куски кода.
Выглядит она так:
можно обойтись и без радиокнопки «Свидетельство», но тк я писал с перспективой на то что возможно будет выдача и удостоверений она тут осталась, текст сообщения вводится если есть какие-то дополнительные сведения он попадёт в шаблон письма о нем будет дальше.
На вход я получаю таблицу от куратора курса которая содержит столбцы:
Наименование мероприятия
Дата проведения
Объём программы
Фамилия
Имя
Отчество
E‑mail
Дата выдачи
Статус обучения
Куратор ФИО
Куратор ТЕЛ
Куратор E‑MAIL
Файл приложения app.py
import os
from flask import Flask, request, render_template
from parse_table import table_courses
from html2pdf import table_cert, tamplate_html
from send_mail import collection_info
UPLOAD_FOLDER = 'upload/'
app = Flask(__name__)
app.config['FILE_UPLOADS'] = UPLOAD_FOLDER
@app.route('/certificate', methods=['GET', 'POST'])
def cert():
if request.method == 'POST':
# Шаблон письма
template_email = 'templates/sample_mail/sample_edu_doc.html'
# Тема письма
subject_email = request.form['subject_email']
# Текст письма
text_email = request.form['text_email']
# таблица с ФИО и адресами
table_email = request.files['table_email']
table_email.save(os.path.join(app.config['FILE_UPLOADS'], table_email.filename))
list_email = table_cert(table_email)
# print(list_email)
cert_list = tamplate_html(list_email)
ok_list, err_list = collection_info(template_email,
subject_email,
list_email=list_email,
file_name=cert_list)
return render_template('list_spam.html', ok_list=ok_list, err_list=err_list)
else:
return render_template('dokuments.html')
if __name__ == '__main__':
app.run()В функции cert описана логика передачи данных на отправку, шаблон письма, тему, текст и таблицу, дальше таблица обрабатывается в файле html2pdf.py
import pandas as pd
list_col = ['Наименование мероприятия',
'Дата проведения',
'Объём программы',
'Фамилия', 'Имя', 'Отчество',
'E-mail',
'Дата выдачи',
'Статус обучения',
'Регистрационный номер',
'Куратор ФИО','Куратор ТЕЛ','Куратор E-MAIL']
def table_cert(file):
table = pd.read_excel(file)
df = pd.DataFrame(table)
table_value = df[list_col].values
# print(table_value)
cert_values = []
for i in table_value:
cert_value = {}
cert_value['event_name'] = i[0]
cert_value['event_date'] = i[1]
cert_value['program_size'] = i[2]
cert_value['surname'] = i[3]
cert_value['name'] = i[4]
cert_value['second_name'] = i[5]
cert_value['email'] = i[6]
cert_value['date_of_issue'] = i[7]
cert_value['status'] = i[8]
cert_value['reg_number'] = i[9]
cert_value['kyrator'] = i[10]
cert_value['kyrator_tel'] = i[11]
cert_value['kyrator_email'] = i[12]
cert_value['cert_file'] = f'{i[3]}{i[4]}{i[5]}_cert.pdf'
cert_values.append(cert_value)
return cert_values
import pdfkit
def html2pdf(name):
path_wkthmltopdf = b'wkhtmltopdf\\bin\wkhtmltopdf.exe'
config = pdfkit.configuration(wkhtmltopdf=path_wkthmltopdf)
css = b'templates/cert/style_new.css'
options = {
'orientation': 'Portrait',
'page-size':'A5',
'margin-bottom': '0mm',
'margin-left': '0mm',
'margin-right': '0mm',
'margin-top': '0mm',
# 'page-width': '7.12in',
}
try:
pdfkit.from_file(f'{name}.html',
f'{name}_cert.pdf',
configuration=config,
options=options, css=css)
except OSError:
pass
from jinja2 import Template
import base64
def image_file_path_to_base64_string(filepath: str) -> str:
with open(filepath, 'rb') as f:
return base64.b64encode(f.read()).decode()
def tamplate_html(table):
name_cert_list = []
for cert_html in table:
context = {
'img_fon': image_file_path_to_base64_string('static/cert/new_fon.png'),
'img_director': image_file_path_to_base64_string('static/cert/подпись.png'),
'img_pechat': image_file_path_to_base64_string('static/cert/печать.png'),
'surname': cert_html.get('surname'),
'name': cert_html.get('name'),
'second_name': cert_html.get('second_name'),
'date': cert_html.get('event_date'),
'subject': cert_html.get('event_name'),
'time': cert_html.get('program_size'),
'number': cert_html.get('reg_number'),
'date_in': cert_html.get('date_of_issue')
}
# print(context)
html = open('templates/cert/index_new.html', encoding='utf-8').read()
tmp = Template(html)
out_file = tmp.render(context)
name_file = f"{cert_html.get('surname')}{cert_html.get('name')}{cert_html.get('second_name')}"
with open(name_file+'.html', 'w', encoding='utf-8') as f:
f.write(out_file)
f.close()
html2pdf(name_file)
name_cert_list.append(f'{name_file}_cert.pdf')
return name_cert_list
В функции table_cert таблица с помощью pandas преобразуется в словарь состоящий из кортежей включающих в себя данные слушателя и название файла сертификата.
В функции html2pdf задаются параметры будущего сертификата: размер, отступы, ориентация, указываются пути до исполняемого файла (он нужен для работы библиотеки pdfkit) и путь к CSS файлу в котором указаны настройки шаблона удостоверения.
В функции image_file_path_to_base64_string картинки конвертируются тк без этого оно не работает.
В функции tamplate_html формируется html шаблон сертификата и конвертируется в .pdf записывая все это в список.
Когда все списки готовы, объявляются две переменные ok_list, err_list они послужат при выводе конечного результата в веб интерфейсе в две колонки успешно отправленные и отправленные с ошибкой, и данные собранные выше передаются на отправку в функцию collection_info.
import re
import os
from config import PORT, SERVER, LOGIN, PWD
import smtplib
from email.mime.application import MIMEApplication
from email.mime.multipart import MIMEMultipart
from email.mime.text import MIMEText
from email.mime.base import MIMEBase
from email import encoders
from email.header import Header
from email.utils import formataddr
from bs4 import BeautifulSoup
from jinja2 import Template
def collection_info(template, subject, list_email, **params):
ok_list, err_list = [], []
for email in list_email:
ok, error = send_email(template,
subject,
email.get('email'),
first_name=email.get('name'),
second_name=email.get('second_name'),
cert_name=email.get('cert_file'),
kyrator=email.get('kyrator'),
kyrator_tel=email.get('kyrator_tel'),
kyrator_email=email.get('kyrator_email'),
**params)
ok_list.append(ok)
err_list.append(error)
return ok_list, err_list
def send_email(template, subject, email, **params):
server = smtplib.SMTP_SSL(SERVER, PORT)
server.login(LOGIN, PWD)
print(f'Переменная email: {email}')
print(f'Переменная params: {params}')
msg = MIMEMultipart()
msg['From'] = LOGIN
msg['To'] = email
msg['Subject'] = Header(subject, 'utf-8')
html = open(template, encoding='utf-8').read()
template_html = Template(html).render(subject_email=subject,
first_name=params.get('first_name'),
second_name=params.get('second_name'),
text_email=params.get('text_email'),
link_form=params.get('link_form'),
link_teacher=params.get('link_teacher'),
kyrator=params.get('kyrator'),
kyrator_tel=params.get('kyrator_tel'),
kyrator_email=params.get('kyrator_email'),
)
body = BeautifulSoup(template_html, 'html.parser')
msg.attach(MIMEText(body, 'html', 'utf-8'))
# Проверяем если вложение есть до прикрепляем к письму
name_attachment = params.get('file_email')
cert_attachment = params.get('cert_name')
if name_attachment:
file_attachment = os.path.basename(name_attachment.filename)
open_attach = MIMEApplication(open('upload/'+name_attachment.filename, 'rb').read())
encoders.encode_base64(open_attach)
open_attach.add_header('Content-Disposition', 'attachment', filename=file_attachment)
msg.attach(open_attach)
elif cert_attachment:
print(cert_attachment)
open_attach = MIMEApplication(open(cert_attachment, 'rb').read())
encoders.encode_base64(open_attach)
open_attach.add_header('Content-Disposition', 'attachment', filename=cert_attachment)
msg.attach(open_attach)
ok, error = [],[]
try:
server.sendmail(LOGIN, msg['To'], msg.as_string())
server.quit()
ok = f"{msg['To']} - OK"
except BaseException as err:
e = re.search('\(([^)]+)', str(err)).group(1)
server.quit()
error = f"{msg['To']} - {e}"
return ok, errorИз полученных данных формируются html шаблоны и рассылаются по адресам с настроенной почты, и создаются два списка которые в последствии выведутся на экран в колонки успешной или неудачной отправки.
Шаблон письма
код под спойлером
Hidden text
Уважаемый(ая) {{ first_name }} {{ second_name }}!
Направляем {{ subject_email }}.
{% if text_email != None %}
{{ text_email }}
{% else %}
{% endif %}
Если у вас остались вопросы, обращайтесь к куратору программы.
Куратор: {{ kyrator }}
Телефон: {{ kyrator_tel }}
E-mail {{ kyrator_email }}
Данное письмо было сформировано автоматически.
Пожалуйста, не отвечайте на него. Электронный адрес **** не является адресом для переписки
Шаблон сертификата
Title
************
*************
СЕРТИФИКАТ
{% if second_name == 'nan' %}
{{ surname }} {{ name }}
{% else %}
{{ surname }} {{ name }} {{ second_name }}
{% endif %}
{{ date }} принял(а) участие в
{{ subject }}
в объёме {{ time }} академических часов
М.П.
Директор _______________ и.И. Иванов
г. Ярославль
{{ date_in }}
На этом вроде ВСЁ
