Атрибут recipients

Атрибут recipients применяется к объекту класса Message и представляет собой список строк с адресами электронной почты. Каждый элемент списка - это один получатель письма. Атрибут можно задавать напрямую или через метод add_recipient. При отправке письма все адреса из этого списка получат сообщение в поле To.

Синтаксис

message.recipients

Пример

Давайте создадим письмо и зададим получателей через атрибут recipients:

from flask import Flask
from flask_mail import Mail, Message

app = Flask(__name__)
app.config['MAIL_SERVER'] = 'smtp.example.com'
app.config['MAIL_PORT'] = 587
app.config['MAIL_USE_TLS'] = True
app.config['MAIL_USERNAME'] = 'user@example.com'
app.config['MAIL_PASSWORD'] = 'password'

mail = Mail(app)

with app.app_context():
	msg = Message(
		subject='hello',
		sender='user@example.com'
	)
	msg.recipients = ['abcde@example.com', 'article@example.com']
	print(msg.recipients)

Результат выполнения кода:

['abcde@example.com', 'article@example.com']

Пример

Давайте добавим получателя к уже существующему списку через метод add_recipient:

from flask import Flask
from flask_mail import Mail, Message

app = Flask(__name__)
app.config['MAIL_SERVER'] = 'smtp.example.com'
app.config['MAIL_PORT'] = 587
app.config['MAIL_USE_TLS'] = True
app.config['MAIL_USERNAME'] = 'user@example.com'
app.config['MAIL_PASSWORD'] = 'password'

mail = Mail(app)

with app.app_context():
	msg = Message(
		subject='hello',
		sender='user@example.com',
		recipients=['abcde@example.com']
	)
	msg.add_recipient('article@example.com')
	print(msg.recipients)

Результат выполнения кода:

['abcde@example.com', 'article@example.com']

Пример

Давайте отправим письмо нескольким получателям и проверим содержимое атрибута перед отправкой:

from flask import Flask
from flask_mail import Mail, Message

app = Flask(__name__)
app.config['MAIL_SERVER'] = 'smtp.example.com'
app.config['MAIL_PORT'] = 587
app.config['MAIL_USE_TLS'] = True
app.config['MAIL_USERNAME'] = 'user@example.com'
app.config['MAIL_PASSWORD'] = 'password'

mail = Mail(app)

@app.route('/send')
def send():
	msg = Message(
		subject='hello',
		sender='user@example.com',
		recipients=['abcde@example.com', 'article@example.com']
	)
	if msg.recipients:
		mail.send(msg)
		return 'sent'
	return 'no recipients'

Результат выполнения кода для адреса /send:

"sent"

Смотрите также

класс Message,
который представляет электронное письмо
метод add_recipient,
который добавляет получателя в список
атрибут cc,
который хранит список копий письма
атрибут bcc,
который хранит список скрытых копий письма