mirror of
https://github.com/wneessen/go-mail.git
synced 2024-12-05 03:10:37 +01:00
Winni Neessen
4c107f4645
Updated several Client methods to accept a smtp.Client pointer, allowing for more flexible and explicit SMTP client management. Added detailed parameter descriptions and extended error handling documentation.
60 lines
2 KiB
Go
60 lines
2 KiB
Go
// SPDX-FileCopyrightText: 2022-2023 The go-mail Authors
|
|
//
|
|
// SPDX-License-Identifier: MIT
|
|
|
|
//go:build go1.20
|
|
// +build go1.20
|
|
|
|
package mail
|
|
|
|
import (
|
|
"errors"
|
|
|
|
"github.com/wneessen/go-mail/smtp"
|
|
)
|
|
|
|
// SendWithSMTPClient attempts to send one or more Msg using a provided smtp.Client with an
|
|
// established connection to the SMTP server. If the smtp.Client has no active connection to
|
|
// the server, SendWithSMTPClient will fail with an error. For each of the provided Msg, it
|
|
// will associate a SendError with the Msg in case of a transmission or delivery error.
|
|
//
|
|
// This method first checks for an active connection to the SMTP server. If the connection is
|
|
// not valid, it returns a SendError. It then iterates over the provided messages, attempting
|
|
// to send each one. If an error occurs during sending, the method records the error and
|
|
// associates it with the corresponding Msg. If multiple errors are encountered, it aggregates
|
|
// them into a single SendError to be returned.
|
|
//
|
|
// Parameters:
|
|
// - client: A pointer to the smtp.Client that holds the connection to the SMTP server
|
|
// - messages: A variadic list of pointers to Msg objects to be sent.
|
|
//
|
|
// Returns:
|
|
// - An error that represents the sending result, which may include multiple SendErrors if
|
|
// any occurred; otherwise, returns nil.
|
|
func (c *Client) SendWithSMTPClient(client *smtp.Client, messages ...*Msg) (returnErr error) {
|
|
escSupport := false
|
|
if client != nil {
|
|
escSupport, _ = client.Extension("ENHANCEDSTATUSCODES")
|
|
}
|
|
if err := c.checkConn(client); err != nil {
|
|
returnErr = &SendError{
|
|
Reason: ErrConnCheck, errlist: []error{err}, isTemp: isTempError(err),
|
|
errcode: errorCode(err), enhancedStatusCode: enhancedStatusCode(err, escSupport),
|
|
}
|
|
return
|
|
}
|
|
|
|
var errs []error
|
|
defer func() {
|
|
returnErr = errors.Join(errs...)
|
|
}()
|
|
|
|
for id, message := range messages {
|
|
if sendErr := c.sendSingleMsg(client, message); sendErr != nil {
|
|
messages[id].sendError = sendErr
|
|
errs = append(errs, sendErr)
|
|
}
|
|
}
|
|
|
|
return
|
|
}
|