id	summary	reporter	owner	description	type	status	component	version	severity	resolution	keywords	cc	stage	has_patch	needs_docs	needs_tests	needs_better_patch	easy	ui_ux
13471	send_mass_mail() example	Greg Taylor	nobody	"I've attached a patch that elaborates on the usage of the datatuple argument to send_mass_mail(). I confused myself with my first attempt at using this function by doing something like:

{{{
('test', 'testmsg', 'noreply@coursebookapp.com', ('snagglepants@gmail.com', 'gtaylor@l11solutions.com'))
}}}

I thought that the documentation was saying that connections were made to the server for each and every recipient in send_mail(), which is not the case. So I took my arguments from send_mail() and constructed a datatuple for send_mass_mail(), since that re-used the same connection. As silly as I later found it was to do this, I think it's worth pointing out the usage of datatuple explicitly so that people can draw this conclusion for themselves.

The patch suggests that send_mass_mail() can be used to send multiple, completely arbitrary emails to one or more completely different set of recipients. I also show that you need a tuple of tuples, rather than a single datatuple."		closed	Documentation	dev		fixed			Accepted	1	0	0	0	0	0