django-celery-email 3.0.0

使用django-celery-email

要为您的项目启用django-celery-email，您需要将djcelery_email添加到INSTALLED_APPS

INSTALLED_APPS += ("djcelery_email",)

然后必须将django-celery-email设置为您的EMAIL_BACKEND

EMAIL_BACKEND = 'djcelery_email.backends.CeleryEmailBackend'

默认情况下，django-celery-email将使用Django内置的SMTP电子邮件后端发送邮件。如果您想使用其他后端，您可以在CELERY_EMAIL_BACKEND中设置它，就像您通常在开始使用Celery之前设置EMAIL_BACKEND一样。实际上，正常的安装程序很可能是先通过Django使邮件工作，然后将EMAIL_BACKEND更改为CELERY_EMAIL_BACKEND，然后添加上面的新EMAIL_BACKEND设置。

群发邮件以大小为CELERY_EMAIL_CHUNK_SIZE（默认为10）的块发送。

如果您需要设置通常可以在自己编写的Celery任务类中设置的任何设置（属性），您可以在CELERY_EMAIL_TASK_CONFIG设置中的dict中指定它们。

CELERY_EMAIL_TASK_CONFIG = {
    'queue' : 'email',
    'rate_limit' : '50/m',  # * CELERY_EMAIL_CHUNK_SIZE (default: 10)
    ...
}

有一些默认设置。除非您指定了其他设置，否则以下设置的等效值将适用

CELERY_EMAIL_TASK_CONFIG = {
    'name': 'djcelery_email_send',
    'ignore_result': True,
}

完成此设置后，如果您有可正常工作的Celery安装，发送邮件将完全像之前一样工作，只是发送将由您的Celery工作进程处理。

from django.core import mail

emails = (
    ('Hey Man', "I'm The Dude! So that's what you call me.", 'dude@aol.com', ['mr@lebowski.com']),
    ('Dammit Walter', "Let's go bowlin'.", 'dude@aol.com', ['wsobchak@vfw.org']),
)
results = mail.send_mass_mail(emails)

results将是一个包含celery AsyncResult对象的列表，您可以忽略它们，或者使用它们来检查邮件投递任务的状态，或者如果您想等待其完成，甚至可以等待其完成。如果您想使用这些，您必须启用结果后端，并在CELERY_EMAIL_TASK_CONFIG中将ignore_result设置为False。如果您关心任务状态和结果，应在设置中将CELERY_EMAIL_CHUNK_SIZE = 1。

有关更多信息，请参阅Celery文档。

len(results)将是您尝试发送的电子邮件数除以CELERY_EMAIL_CHUNK_SIZE的结果，并且这并不反映它们的投递成功或失败。

变更日志