go-pkgz / email / 42376391897

94%

master: 93%

Build Type

Pull #33

github

Committed by paskal

Commit Message

Add SendBatch to send several messages over one connection

Previously, Send ended the SMTP session after each message, including
when a client was supplied through the SMTP option, so a batch of
emails meant one session per message.

SendBatch reuses one connection, authenticating once when credentials
are configured and sending each valid message in its own transaction.
After a rejection by the server it continues only if RSET succeeds.
RSET comes from the new single-method SMTPResetter interface, which
smtp.Client implements; SMTPClient is unchanged, so existing
implementations keep compiling. A failed or unavailable reset, a
connection failure or a cancelled or expired context stops the rest
of the batch. BatchError reports the result of every message, and its
Is and As methods let errors.Is and errors.As look into it on Go 1.19,
which does not follow a multi-error Unwrap.

The authentication, transaction and QUIT steps of SendContext move
into helpers shared with SendBatch, without a change in its behaviour.

Pull Request Pull Request #33: Add SendBatch to send several messages over one connection

Coverage Stats

121 of 124 new or added lines in 1 file covered. (97.58%)

28 existing lines in 1 file now uncovered.

490 of 522 relevant lines covered (93.87%)

177.48 hits per line