mail

Jul 9, 2026

Changes in this version

+ var ErrNoHTTPSUnsubURL = errors.New(...)

+ var ErrNoPreferredAuthMechanism = errors.New("no preferred auth mechanism provided")

type Msg

+ func (m *Msg) SetListUnsubscribe(uris ...string)

+ func (m *Msg) SetListUnsubscribeOneClick(httpsURL string, additionalURIs ...string) error

+ func (m *Msg) SetListUnsubscribePost()

type Option

+ func WithOpportunisticSMTPAuth(preferredMechs ...SMTPAuthType) Option

type SMTPAuthType

+ const SMTPAuthOpportunistic

Jul 4, 2026

Changes in this version

+ var ErrNTLMAuthNotSupported = errors.New("server does not support SMTP AUTH type: NTLM")

+ func PrivKeyFromPEM(pemBytes []byte) (crypto.Signer, error)

+ type Canonicalization = dkim.Canonicalization

+ const CanonicalizationRelaxed

+ const CanonicalizationSimple

type Client

+ func (c *Client) SetAlwaysDKIMSign(signer *dkim.Signer) error

+ func (c *Client) SetDomain(domain string)

+ type DKIMSigner = dkim.Signer

+ func NewDKIMSigner(domain, selector string, privKey crypto.Signer) *DKIMSigner

type Msg

+ func (m *Msg) AddAlternativeNamedHTMLTemplate(tpl *ht.Template, name string, data any, opts ...PartOption) error

+ func (m *Msg) AddAlternativeNamedTextTemplate(tpl *tt.Template, name string, data any, opts ...PartOption) error

+ func (m *Msg) AttachNamedHTMLTemplate(fileName string, tpl *ht.Template, tplName string, data any, ...) error

+ func (m *Msg) AttachNamedTextTemplate(fileName string, tpl *tt.Template, tplName string, data any, ...) error

+ func (m *Msg) EmbedNamedHTMLTemplate(fileName string, tpl *ht.Template, tplName string, data any, ...) error

+ func (m *Msg) EmbedNamedTextTemplate(fileName string, tpl *tt.Template, tplName string, data any, ...) error

+ func (m *Msg) SetBodyNamedHTMLTemplate(tpl *ht.Template, name string, data any, opts ...PartOption) error

+ func (m *Msg) SetBodyNamedTextTemplate(tpl *tt.Template, name string, data any, opts ...PartOption) error

+ func (m *Msg) SetDKIM(signer *dkim.Signer)

type MsgOption

+ func WithDKIM(signer *dkim.Signer) MsgOption

type Option

+ func WithAlwaysDKIMSign(signer *dkim.Signer) Option

+ func WithDomain(domain string) Option

+ func WithoutRset() Option

type SMTPAuthType

+ const SMTPAuthNTLM

May 12, 2026

Changes in this version

+ var ErrClientIsNil = errors.New("client is nil")

type Msg

+ func (m *Msg) GetReplyTo() []*mail.Address

type Option

+ func WithoutSMTPUTF8() Option

Sep 12, 2025 GO-2025-3988

  GO-2025-3988: Insufficient address encoding when passing mail addresses to the SMTP client in github.com/wneessen/go-mail

Changes in this version

+ func IsAddrHeader(header string) bool

type Client

+ ErrorHandlerRegistry *smtp.ErrorHandlerRegistry

type Msg

+ func (m *Msg) AddBccMailAddress(rcpt *mail.Address)

+ func (m *Msg) AddCcMailAddress(rcpt *mail.Address)

+ func (m *Msg) AddToMailAddress(rcpt *mail.Address)

+ func (m *Msg) BccMailAddress(rcpts ...*mail.Address)

+ func (m *Msg) CcMailAddress(rcpts ...*mail.Address)

+ func (m *Msg) EnvelopeFromMailAddress(addr *mail.Address)

+ func (m *Msg) FromMailAddress(from *mail.Address)

+ func (m *Msg) ReplyToMailAddress(addr *mail.Address)

+ func (m *Msg) ServerResponse() string

+ func (m *Msg) SetAddrHeaderFromMailAddress(header AddrHeader, values ...*mail.Address)

+ func (m *Msg) ToMailAddress(rcpts ...*mail.Address)

Feb 16, 2025 GO-2025-3988

  GO-2025-3988: Insufficient address encoding when passing mail addresses to the SMTP client in github.com/wneessen/go-mail

Jan 12, 2025 GO-2025-3988

  GO-2025-3988: Insufficient address encoding when passing mail addresses to the SMTP client in github.com/wneessen/go-mail

Jan 9, 2025 GO-2025-3988

  GO-2025-3988: Insufficient address encoding when passing mail addresses to the SMTP client in github.com/wneessen/go-mail

Changes in this version

+ var ErrCertificateMissing = errors.New("certificate is missing")

+ var ErrNoSupportedAuthDiscovered = errors.New(...)

+ var ErrPrivateKeyMissing = errors.New("private key is missing")

+ type AuthData struct

+ Auth bool

+ Password string

+ Username string

+ func NewAuthData(user, pass string) *AuthData

type Client

+ func (c *Client) CloseWithSMTPClient(client *smtp.Client) error

+ func (c *Client) DialToSMTPClientWithContext(ctxDial context.Context) (*smtp.Client, error)

+ func (c *Client) ResetWithSMTPClient(client *smtp.Client) error

+ func (c *Client) SendWithSMTPClient(client *smtp.Client, messages ...*Msg) (returnErr error)

+ func (c *Client) SetDebugLogWithSMTPClient(client *smtp.Client, val bool)

+ func (c *Client) SetLoggerWithSMTPClient(client *smtp.Client, logger log.Logger)

type ContentType

+ const TypeSMIMESigned

type MIMEType

+ const MIMESMIMESigned

+ func (e MIMEType) String() string

type Msg

+ func QuickSend(addr string, auth *AuthData, from string, rcpts []string, subject string, ...) (*Msg, error)

+ func (m *Msg) AttachFromIOFS(name string, iofs fs.FS, opts ...FileOption) error

+ func (m *Msg) EmbedFromIOFS(name string, iofs fs.FS, opts ...FileOption) error

+ func (m *Msg) SignWithKeypair(privateKey crypto.PrivateKey, certificate *x509.Certificate, ...) error

+ func (m *Msg) SignWithTLSCertificate(keyPairTLS *tls.Certificate) error

type Part

+ func (p *Part) SetIsSMIMESigned(smime bool)

type PartOption

+ func WithSMIMESigning() PartOption

+ type SMIME struct

type SMTPAuthType

+ const SMTPAuthAutoDiscover

type SendError

+ func (e *SendError) EnhancedStatusCode() string

+ func (e *SendError) ErrorCode() int

Nov 6, 2024 GO-2025-3988

  GO-2025-3988: Insufficient address encoding when passing mail addresses to the SMTP client in github.com/wneessen/go-mail

Changes in this version

+ var ErrDialContextFuncIsNil = errors.New("dial context function is nil")

+ var ErrSMTPAuthMethodIsNil = errors.New("SMTP auth method is nil")

type SMTPAuthType

+ const SMTPAuthLoginNoEnc

+ const SMTPAuthPlainNoEnc

+ func (sa *SMTPAuthType) UnmarshalString(value string) error

Oct 16, 2024 GO-2025-3988

  GO-2025-3988: Insufficient address encoding when passing mail addresses to the SMTP client in github.com/wneessen/go-mail

Changes in this version

type Client

+ func (c *Client) SetLogAuthData(logAuth bool)

type Option

+ func WithLogAuthData() Option

Oct 6, 2024 GO-2025-3988

  GO-2025-3988: Insufficient address encoding when passing mail addresses to the SMTP client in github.com/wneessen/go-mail

Changes in this version

+ var ErrSCRAMSHA1AuthNotSupported = errors.New("server does not support SMTP AUTH type: SCRAM-SHA-1")

+ var ErrSCRAMSHA1PLUSAuthNotSupported = errors.New("server does not support SMTP AUTH type: SCRAM-SHA-1-PLUS")

+ var ErrSCRAMSHA256AuthNotSupported = errors.New("server does not support SMTP AUTH type: SCRAM-SHA-256")

+ var ErrSCRAMSHA256PLUSAuthNotSupported = errors.New("server does not support SMTP AUTH type: SCRAM-SHA-256-PLUS")

type Msg

+ func (m *Msg) GetMessageID() string

type SMTPAuthType

+ const SMTPAuthCustom

+ const SMTPAuthSCRAMSHA1

+ const SMTPAuthSCRAMSHA1PLUS

+ const SMTPAuthSCRAMSHA256

+ const SMTPAuthSCRAMSHA256PLUS

type SendError

+ func (e *SendError) MessageID() string

+ func (e *SendError) Msg() *Msg

Sep 3, 2024 GO-2025-3988

  GO-2025-3988: Insufficient address encoding when passing mail addresses to the SMTP client in github.com/wneessen/go-mail

Aug 16, 2024 GO-2025-3988

  GO-2025-3988: Insufficient address encoding when passing mail addresses to the SMTP client in github.com/wneessen/go-mail

Changes in this version

type Encoding

+ const EncodingUSASCII

type Msg

+ func (m *Msg) GetBoundary() string

+ func (m *Msg) SetAttachments(files []*File)

Jun 28, 2024 GO-2025-3988

  GO-2025-3988: Insufficient address encoding when passing mail addresses to the SMTP client in github.com/wneessen/go-mail

Changes in this version

type ContentType

+ const TypeMultipartAlternative

+ const TypeMultipartMixed

+ const TypeMultipartRelated

+ func (c ContentType) String() string

type FileOption

+ func WithFileContentID(id string) FileOption

type Header

+ const HeaderReferences

type MIMEVersion

+ const MIME10

type Msg

+ func EMLToMsgFromFile(filePath string) (*Msg, error)

+ func EMLToMsgFromReader(reader io.Reader) (*Msg, error)

+ func EMLToMsgFromString(emlString string) (*Msg, error)

type MsgOption

+ func WithNoDefaultUserAgent() MsgOption

type SMTPAuthType

+ const SMTPAuthNoAuth

Feb 14, 2024 GO-2025-3988

  GO-2025-3988: Insufficient address encoding when passing mail addresses to the SMTP client in github.com/wneessen/go-mail

Changes in this version

+ const DefaultPortSSL

+ const DefaultPortTLS

type Client

+ func (c *Client) SetSSLPort(ssl bool, fb bool)

+ func (c *Client) SetTLSPortPolicy(p TLSPolicy)

type Header

+ const HeaderXAutoResponseSuppress

type Msg

+ func (m *Msg) BccFromString(v string) error

+ func (m *Msg) CcFromString(v string) error

+ func (m *Msg) IsDelivered() bool

+ func (m *Msg) ToFromString(v string) error

+ func (m *Msg) UnsetAllAttachments()

+ func (m *Msg) UnsetAllEmbeds()

+ func (m *Msg) UnsetAllParts()

type Option

+ func WithSSLPort(fb bool) Option

+ func WithTLSPortPolicy(p TLSPolicy) Option

type Part

+ func (p *Part) GetCharset() Charset

+ func (p *Part) SetCharset(c Charset)

type PartOption

+ func WithPartCharset(c Charset) PartOption

Jun 4, 2023 GO-2025-3988

  GO-2025-3988: Insufficient address encoding when passing mail addresses to the SMTP client in github.com/wneessen/go-mail

Changes in this version

+ var ErrXOauth2AuthNotSupported = errors.New("server does not support SMTP AUTH type: XOAUTH2")

+ type DialContextFunc func(ctx context.Context, network, address string) (net.Conn, error)

type Option

+ func WithDialContextFunc(f DialContextFunc) Option

type SMTPAuthType

+ const SMTPAuthXOAUTH2

Mar 15, 2023 GO-2025-3988

  GO-2025-3988: Insufficient address encoding when passing mail addresses to the SMTP client in github.com/wneessen/go-mail

Changes in this version

type Client

+ func (c *Client) SetDebugLog(v bool)

+ func (c *Client) SetLogger(l log.Logger)

type ContentType

+ const TypePGPEncrypted

+ const TypePGPSignature

type File

+ ContentType ContentType

+ Desc string

+ Enc Encoding

type FileOption

+ func WithFileContentType(t ContentType) FileOption

+ func WithFileDescription(d string) FileOption

+ func WithFileEncoding(e Encoding) FileOption

type Header

+ const HeaderContentDescription

type Msg

+ func (m *Msg) AttachReadSeeker(n string, r io.ReadSeeker, o ...FileOption)

+ func (m *Msg) EmbedReadSeeker(n string, r io.ReadSeeker, o ...FileOption)

+ func (m *Msg) GetEmbeds() []*File

+ func (m *Msg) SetEmbeds(ff []*File)

+ func (m *Msg) SetPGPType(t PGPType)

type MsgOption

+ func WithPGPType(t PGPType) MsgOption

type Option

+ func WithDebugLog() Option

+ func WithLogger(l log.Logger) Option

+ type PGPType int

+ const NoPGP

+ const PGPEncrypt

+ const PGPSignature

type Part

+ func (p *Part) Delete()

+ func (p *Part) GetDescription() string

+ func (p *Part) SetDescription(d string)

type PartOption

+ func WithPartContentDescription(d string) PartOption

Jan 7, 2023 GO-2025-3988

  GO-2025-3988: Insufficient address encoding when passing mail addresses to the SMTP client in github.com/wneessen/go-mail

Jan 3, 2023 GO-2025-3988

  GO-2025-3988: Insufficient address encoding when passing mail addresses to the SMTP client in github.com/wneessen/go-mail

Changes in this version

type Msg

+ func (m *Msg) HasSendError() bool

+ func (m *Msg) SendError() error

+ func (m *Msg) SendErrorIsTemp() bool

+ type SendErrReason int

+ const ErrAmbiguous

+ const ErrConnCheck

+ const ErrGetRcpts

+ const ErrGetSender

+ const ErrNoUnencoded

+ const ErrSMTPData

+ const ErrSMTPDataClose

+ const ErrSMTPMailFrom

+ const ErrSMTPRcptTo

+ const ErrSMTPReset

+ const ErrWriteContent

+ func (r SendErrReason) String() string

+ type SendError struct

+ Reason SendErrReason

+ func (e *SendError) Error() string

+ func (e *SendError) Is(et error) bool

+ func (e *SendError) IsTemp() bool

Dec 26, 2022 GO-2025-3988

  GO-2025-3988: Insufficient address encoding when passing mail addresses to the SMTP client in github.com/wneessen/go-mail

Changes in this version

type Option

+ func WithoutNoop() Option

Nov 19, 2022 GO-2025-3988

  GO-2025-3988: Insufficient address encoding when passing mail addresses to the SMTP client in github.com/wneessen/go-mail

Changes in this version

type Msg

+ func (m *Msg) GetAddrHeader(h AddrHeader) []*mail.Address

+ func (m *Msg) GetAddrHeaderString(h AddrHeader) []string

+ func (m *Msg) GetBcc() []*mail.Address

+ func (m *Msg) GetBccString() []string

+ func (m *Msg) GetCc() []*mail.Address

+ func (m *Msg) GetCcString() []string

+ func (m *Msg) GetFrom() []*mail.Address

+ func (m *Msg) GetFromString() []string

+ func (m *Msg) GetTo() []*mail.Address

+ func (m *Msg) GetToString() []string

+ func (m *Msg) SetGenHeader(h Header, v ...string)

+ func (m *Msg) SetGenHeaderPreformatted(h Header, v string)

Oct 26, 2022 GO-2025-3988

  GO-2025-3988: Insufficient address encoding when passing mail addresses to the SMTP client in github.com/wneessen/go-mail

Changes in this version

type Msg

+ func (m *Msg) SetHeaderPreformatted(h Header, v string)

Oct 25, 2022 GO-2025-3988

  GO-2025-3988: Insufficient address encoding when passing mail addresses to the SMTP client in github.com/wneessen/go-mail

Changes in this version

type Middleware

+ Type func() MiddlewareType

+ type MiddlewareType string

type Msg

+ func (m *Msg) WriteToSkipMiddleware(w io.Writer, mt MiddlewareType) (int64, error)

Oct 20, 2022 GO-2025-3988

  GO-2025-3988: Insufficient address encoding when passing mail addresses to the SMTP client in github.com/wneessen/go-mail

Changes in this version

type Msg

+ func (m *Msg) NewReader() *Reader

+ func (m *Msg) UpdateReader(r *Reader)

+ type Reader struct

+ func (r *Reader) Error() error

+ func (r *Reader) Read(p []byte) (n int, err error)

+ func (r *Reader) Reset()

Oct 12, 2022 GO-2025-3988

  GO-2025-3988: Insufficient address encoding when passing mail addresses to the SMTP client in github.com/wneessen/go-mail

Changes in this version

type Msg

+ func (m *Msg) GetAttachments() []*File

+ func (m *Msg) SetAttachements(ff []*File)

Oct 11, 2022 GO-2025-3988

  GO-2025-3988: Insufficient address encoding when passing mail addresses to the SMTP client in github.com/wneessen/go-mail

Changes in this version

type Msg

+ func (m *Msg) GetParts() []*Part

type Part

+ func (p *Part) GetContent() ([]byte, error)

+ func (p *Part) GetContentType() ContentType

+ func (p *Part) GetEncoding() Encoding

+ func (p *Part) GetWriteFunc() func(io.Writer) (int64, error)

+ func (p *Part) SetContent(c string)

+ func (p *Part) SetContentType(c ContentType)

+ func (p *Part) SetWriteFunc(w func(io.Writer) (int64, error))

Oct 2, 2022 GO-2025-3988

  GO-2025-3988: Insufficient address encoding when passing mail addresses to the SMTP client in github.com/wneessen/go-mail

Changes in this version

type Msg

+ func (m *Msg) GetGenHeader(h Header) []string

Sep 26, 2022 GO-2025-3988

  GO-2025-3988: Insufficient address encoding when passing mail addresses to the SMTP client in github.com/wneessen/go-mail

Changes in this version

type Client

+ func (c *Client) DialAndSendWithContext(ctx context.Context, ml ...*Msg) error

+ type Middleware interface

+ Handle func(*Msg) *Msg

type MsgOption

+ func WithMiddleware(mw Middleware) MsgOption

Sep 12, 2022 GO-2025-3988

  GO-2025-3988: Insufficient address encoding when passing mail addresses to the SMTP client in github.com/wneessen/go-mail

Changes in this version

+ const DSNMailReturnFull

+ const DSNMailReturnHeadersOnly

+ const DSNRcptNotifyDelay

+ const DSNRcptNotifyFailure

+ const DSNRcptNotifyNever

+ const DSNRcptNotifySuccess

+ const ErrNoOutWriter

+ var ErrInvalidDSNMailReturnOption = errors.New("DSN mail return option can only be HDRS or FULL")

+ var ErrInvalidDSNRcptNotifyCombination = errors.New(...)

+ var ErrInvalidDSNRcptNotifyOption = errors.New(...)

+ type DSNMailReturnOption string

+ type DSNRcptNotifyOption string

type Header

+ const HeaderDispositionNotificationTo

type Msg

+ func (m *Msg) RequestMDNAddTo(t string) error

+ func (m *Msg) RequestMDNAddToFormat(n, a string) error

+ func (m *Msg) RequestMDNTo(t ...string) error

+ func (m *Msg) RequestMDNToFormat(n, a string) error

type Option

+ func WithDSN() Option

+ func WithDSNMailReturnType(mro DSNMailReturnOption) Option

+ func WithDSNRcptNotifyType(rno ...DSNRcptNotifyOption) Option

Aug 14, 2022 GO-2025-3988

  GO-2025-3988: Insufficient address encoding when passing mail addresses to the SMTP client in github.com/wneessen/go-mail

Changes in this version

+ const MaxBodyLength

+ type Base64LineBreaker struct

+ func (l *Base64LineBreaker) Close() (err error)

+ func (l *Base64LineBreaker) Write(b []byte) (n int, err error)

Jul 7, 2022 GO-2025-3988

  GO-2025-3988: Insufficient address encoding when passing mail addresses to the SMTP client in github.com/wneessen/go-mail

Changes in this version

type Msg

+ func (m *Msg) AttachFromEmbedFS(n string, f *embed.FS, o ...FileOption) error

+ func (m *Msg) EmbedFromEmbedFS(n string, f *embed.FS, o ...FileOption) error

Jun 13, 2022 GO-2025-3988

  GO-2025-3988: Insufficient address encoding when passing mail addresses to the SMTP client in github.com/wneessen/go-mail

Changes in this version

type AddrHeader

+ const HeaderEnvelopeFrom

type Msg

+ func (m *Msg) EnvelopeFrom(f string) error

+ func (m *Msg) EnvelopeFromFormat(n, a string) error

Jun 9, 2022 GO-2025-3988

  GO-2025-3988: Insufficient address encoding when passing mail addresses to the SMTP client in github.com/wneessen/go-mail

Changes in this version

type Msg

+ func (m *Msg) WriteToFile(n string) error

+ func (m *Msg) WriteToTempFile() (string, error)

Jun 3, 2022 GO-2025-3988

  GO-2025-3988: Insufficient address encoding when passing mail addresses to the SMTP client in github.com/wneessen/go-mail

Changes in this version

type Msg

+ func (m *Msg) AddAlternativeHTMLTemplate(t *ht.Template, d interface{}, o ...PartOption) error

+ func (m *Msg) AddAlternativeTextTemplate(t *tt.Template, d interface{}, o ...PartOption) error

+ func (m *Msg) AttachHTMLTemplate(n string, t *ht.Template, d interface{}, o ...FileOption) error

+ func (m *Msg) AttachTextTemplate(n string, t *tt.Template, d interface{}, o ...FileOption) error

+ func (m *Msg) EmbedHTMLTemplate(n string, t *ht.Template, d interface{}, o ...FileOption) error

+ func (m *Msg) EmbedTextTemplate(n string, t *tt.Template, d interface{}, o ...FileOption) error

+ func (m *Msg) SetBodyHTMLTemplate(t *ht.Template, d interface{}, o ...PartOption) error

+ func (m *Msg) SetBodyTextTemplate(t *tt.Template, d interface{}, o ...PartOption) error

May 28, 2022 GO-2025-3988

  GO-2025-3988: Insufficient address encoding when passing mail addresses to the SMTP client in github.com/wneessen/go-mail

Changes in this version

type Msg

+ func (m *Msg) Read(p []byte) (int, error)

May 27, 2022 GO-2025-3988

  GO-2025-3988: Insufficient address encoding when passing mail addresses to the SMTP client in github.com/wneessen/go-mail

May 25, 2022 GO-2025-3988

  GO-2025-3988: Insufficient address encoding when passing mail addresses to the SMTP client in github.com/wneessen/go-mail

Changes in this version

+ const DoubleNewLine

+ const SingleNewLine

type Msg

+ func (m *Msg) WriteTo(w io.Writer) (int64, error)

May 25, 2022 GO-2025-3988

  GO-2025-3988: Insufficient address encoding when passing mail addresses to the SMTP client in github.com/wneessen/go-mail

Mar 21, 2022 GO-2025-3988

  GO-2025-3988: Insufficient address encoding when passing mail addresses to the SMTP client in github.com/wneessen/go-mail

Mar 20, 2022 GO-2025-3988

  GO-2025-3988: Insufficient address encoding when passing mail addresses to the SMTP client in github.com/wneessen/go-mail

Mar 20, 2022 GO-2025-3988

  GO-2025-3988: Insufficient address encoding when passing mail addresses to the SMTP client in github.com/wneessen/go-mail

Changes in this version

+ const VERSION

Mar 18, 2022 GO-2025-3988

  GO-2025-3988: Insufficient address encoding when passing mail addresses to the SMTP client in github.com/wneessen/go-mail

Changes in this version

type Msg

+ func (m *Msg) WriteToSendmailWithCommand(sp string) error

Mar 18, 2022 GO-2025-3988

  GO-2025-3988: Insufficient address encoding when passing mail addresses to the SMTP client in github.com/wneessen/go-mail

Changes in this version

+ const DefaultTLSMinVersion

+ var ErrInvalidHELO = errors.New("invalid HELO/EHLO value - must not be empty")

+ var ErrInvalidPort = errors.New("invalid port number")

+ var ErrInvalidTLSConfig = errors.New("invalid TLS config")

+ var ErrInvalidTimeout = errors.New("timeout cannot be zero or negative")

type AddrHeader

+ func (a AddrHeader) String() string

type Client

+ func (c *Client) SetSSL(s bool)

type Header

+ func (h Header) String() string

type MsgOption

+ func WithBoundary(b string) MsgOption

Mar 14, 2022 GO-2025-3988

  GO-2025-3988: Insufficient address encoding when passing mail addresses to the SMTP client in github.com/wneessen/go-mail

Changes in this version

type Header

+ const HeaderContentLocation

+ const HeaderOrganization

+ const HeaderUserAgent

+ const HeaderXMailer

type Msg

+ func (m *Msg) SetOrganization(o string)

+ func (m *Msg) SetUserAgent(a string)

Mar 14, 2022 GO-2025-3988

  GO-2025-3988: Insufficient address encoding when passing mail addresses to the SMTP client in github.com/wneessen/go-mail

Changes in this version

+ const SendmailPath

type Msg

+ func (m *Msg) Reset()

+ func (m *Msg) SetDateWithValue(t time.Time)

+ func (m *Msg) WriteToSendmail() error

+ func (m *Msg) WriteToSendmailWithContext(ctx context.Context, sp string, a ...string) error

Mar 14, 2022 GO-2025-3988

  GO-2025-3988: Insufficient address encoding when passing mail addresses to the SMTP client in github.com/wneessen/go-mail

Changes in this version

+ var ErrServerNoUnencoded = errors.New("message is 8bit unencoded, but server does not support 8BITMIME")

+ type File struct

+ Header textproto.MIMEHeader

+ Name string

+ Writer func(w io.Writer) error

+ type FileOption func(*File)

+ func WithFileName(n string) FileOption

type Header

+ const HeaderContentID

type Msg

+ func (m *Msg) AttachFile(n string, o ...FileOption)

+ func (m *Msg) AttachReader(n string, r io.Reader, o ...FileOption)

+ func (m *Msg) EmbedFile(n string, o ...FileOption)

+ func (m *Msg) EmbedReader(n string, r io.Reader, o ...FileOption)

Mar 13, 2022 GO-2025-3988

  GO-2025-3988: Insufficient address encoding when passing mail addresses to the SMTP client in github.com/wneessen/go-mail

Changes in this version

+ const DefaultPort

+ const DefaultTLSPolicy

+ const DefaultTimeout

+ const MaxHeaderLength

+ var ErrCramMD5AuthNotSupported = errors.New("server does not support SMTP AUTH type: CRAM-MD5")

+ var ErrDeadlineExtendFailed = errors.New("connection deadline extension failed")

+ var ErrLoginAuthNotSupported = errors.New("server does not support SMTP AUTH type: LOGIN")

+ var ErrNoActiveConnection = errors.New("not connected to SMTP server")

+ var ErrNoFromAddress = errors.New("no FROM address set")

+ var ErrNoHostname = errors.New("hostname for client cannot be empty")

+ var ErrNoRcptAddresses = errors.New("no recipient addresses set")

+ var ErrPlainAuthNotSupported = errors.New("server does not support SMTP AUTH type: PLAIN")

+ type AddrHeader string

+ const HeaderBcc

+ const HeaderCc

+ const HeaderFrom

+ const HeaderTo

+ type Charset string

+ const CharsetASCII

+ const CharsetBig5

+ const CharsetEUCKR

+ const CharsetGB18030

+ const CharsetGB2312

+ const CharsetGBK

+ const CharsetISO2022JP

+ const CharsetISO2022KR

+ const CharsetISO88591

+ const CharsetISO885913

+ const CharsetISO885914

+ const CharsetISO885915

+ const CharsetISO885916

+ const CharsetISO88592

+ const CharsetISO88593

+ const CharsetISO88594

+ const CharsetISO88595

+ const CharsetISO88596

+ const CharsetISO88597

+ const CharsetISO88599

+ const CharsetKOI8R

+ const CharsetKOI8U

+ const CharsetShiftJIS

+ const CharsetTIS620

+ const CharsetUTF7

+ const CharsetUTF8

+ const CharsetUnknown

+ const CharsetWindows1250

+ const CharsetWindows1251

+ const CharsetWindows1252

+ const CharsetWindows1255

+ const CharsetWindows1256

+ func (c Charset) String() string

+ type Client struct

+ func NewClient(h string, o ...Option) (*Client, error)

+ func (c *Client) Close() error

+ func (c *Client) DialAndSend(ml ...*Msg) error

+ func (c *Client) DialWithContext(pc context.Context) error

+ func (c *Client) Reset() error

+ func (c *Client) Send(ml ...*Msg) error

+ func (c *Client) ServerAddr() string

+ func (c *Client) SetPassword(p string)

+ func (c *Client) SetSMTPAuth(a SMTPAuthType)

+ func (c *Client) SetSMTPAuthCustom(sa smtp.Auth)

+ func (c *Client) SetTLSConfig(co *tls.Config)

+ func (c *Client) SetTLSPolicy(p TLSPolicy)

+ func (c *Client) SetUsername(u string)

+ func (c *Client) TLSPolicy() string

+ type ContentType string

+ const TypeAppOctetStream

+ const TypeTextHTML

+ const TypeTextPlain

+ type Encoding string

+ const EncodingB64

+ const EncodingQP

+ const NoEncoding

+ func (e Encoding) String() string

+ type Header string

+ const HeaderContentDisposition

+ const HeaderContentLang

+ const HeaderContentTransferEnc

+ const HeaderContentType

+ const HeaderDate

+ const HeaderImportance

+ const HeaderInReplyTo

+ const HeaderListUnsubscribe

+ const HeaderListUnsubscribePost

+ const HeaderMIMEVersion

+ const HeaderMessageID

+ const HeaderPrecedence

+ const HeaderPriority

+ const HeaderReplyTo

+ const HeaderSubject

+ const HeaderXMSMailPriority

+ const HeaderXPriority

+ type Importance int

+ const ImportanceHigh

+ const ImportanceLow

+ const ImportanceNonUrgent

+ const ImportanceNormal

+ const ImportanceUrgent

+ func (i Importance) NumString() string

+ func (i Importance) String() string

+ func (i Importance) XPrioString() string

+ type MIMEType string

+ const MIMEAlternative

+ const MIMEMixed

+ const MIMERelated

+ type MIMEVersion string

+ const Mime10

+ type Msg struct

+ func NewMsg(o ...MsgOption) *Msg

+ func (m *Msg) AddAlternativeString(ct ContentType, b string, o ...PartOption)

+ func (m *Msg) AddAlternativeWriter(ct ContentType, w func(io.Writer) error, o ...PartOption)

+ func (m *Msg) AddBcc(t string) error

+ func (m *Msg) AddBccFormat(n, a string) error

+ func (m *Msg) AddCc(t string) error

+ func (m *Msg) AddCcFormat(n, a string) error

+ func (m *Msg) AddTo(t string) error

+ func (m *Msg) AddToFormat(n, a string) error

+ func (m *Msg) Bcc(b ...string) error

+ func (m *Msg) BccIgnoreInvalid(b ...string)

+ func (m *Msg) Cc(c ...string) error

+ func (m *Msg) CcIgnoreInvalid(c ...string)

+ func (m *Msg) Charset() string

+ func (m *Msg) Encoding() string

+ func (m *Msg) From(f string) error

+ func (m *Msg) FromFormat(n, a string) error

+ func (m *Msg) GetRecipients() ([]string, error)

+ func (m *Msg) GetSender(ff bool) (string, error)

+ func (m *Msg) NewPart(ct ContentType, o ...PartOption) *Part

+ func (m *Msg) ReplyTo(r string) error

+ func (m *Msg) ReplyToFormat(n, a string) error

+ func (m *Msg) SetAddrHeader(h AddrHeader, v ...string) error

+ func (m *Msg) SetAddrHeaderIgnoreInvalid(h AddrHeader, v ...string)

+ func (m *Msg) SetBodyString(ct ContentType, b string, o ...PartOption)

+ func (m *Msg) SetBodyWriter(ct ContentType, w func(io.Writer) error, o ...PartOption)

+ func (m *Msg) SetBoundary(b string)

+ func (m *Msg) SetBulk()

+ func (m *Msg) SetCharset(c Charset)

+ func (m *Msg) SetDate()

+ func (m *Msg) SetEncoding(e Encoding)

+ func (m *Msg) SetHeader(h Header, v ...string)

+ func (m *Msg) SetImportance(i Importance)

+ func (m *Msg) SetMIMEVersion(mv MIMEVersion)

+ func (m *Msg) SetMessageID()

+ func (m *Msg) SetMessageIDWithValue(v string)

+ func (m *Msg) Subject(s string)

+ func (m *Msg) To(t ...string) error

+ func (m *Msg) ToIgnoreInvalid(t ...string)

+ func (m *Msg) Write(w io.Writer) (int64, error)

+ type MsgOption func(*Msg)

+ func WithCharset(c Charset) MsgOption

+ func WithEncoding(e Encoding) MsgOption

+ func WithMIMEVersion(mv MIMEVersion) MsgOption

+ type Option func(*Client)

+ func WithHELO(h string) Option

+ func WithPassword(p string) Option

+ func WithPort(p int) Option

+ func WithSMTPAuth(t SMTPAuthType) Option

+ func WithSMTPAuthCustom(a smtp.Auth) Option

+ func WithSSL() Option

+ func WithTLSConfig(co *tls.Config) Option

+ func WithTLSPolicy(p TLSPolicy) Option

+ func WithTimeout(t time.Duration) Option

+ func WithUsername(u string) Option

+ type Part struct

+ func (p *Part) SetEncoding(e Encoding)

+ type PartOption func(*Part)

+ func WithPartEncoding(e Encoding) PartOption

+ type SMTPAuthType string

+ const SMTPAuthCramMD5

+ const SMTPAuthLogin

+ const SMTPAuthPlain

+ type TLSPolicy int

+ const NoTLS

+ const TLSMandatory

+ const TLSOpportunistic

+ func (p TLSPolicy) String() string