package smtpclient_test import ( "context" "log" "net" "strings" "golang.org/x/exp/slog" "github.com/mjl-/mox/dns" "github.com/mjl-/mox/sasl" "github.com/mjl-/mox/smtpclient" ) func ExampleClient() { // Submit a message to an SMTP server, with authentication. The SMTP server is // responsible for getting the message delivered. // Make TCP connection to submission server. conn, err := net.Dial("tcp", "submit.example.org:465") if err != nil { log.Fatalf("dial submission server: %v", err) } defer conn.Close() // Initialize the SMTP session, with a EHLO, STARTTLS and authentication. // Verify the server TLS certificate with PKIX/WebPKI. ctx := context.Background() tlsVerifyPKIX := true opts := smtpclient.Opts{ Auth: []sasl.Client{ // Prefer strongest authentication mechanism, allow up to older CRAM-MD5. sasl.NewClientSCRAMSHA256("mjl", "test1234"), sasl.NewClientSCRAMSHA1("mjl", "test1234"), sasl.NewClientCRAMMD5("mjl", "test1234"), }, } localname := dns.Domain{ASCII: "localhost"} remotename := dns.Domain{ASCII: "submit.example.org"} client, err := smtpclient.New(ctx, slog.Default(), conn, smtpclient.TLSImmediate, tlsVerifyPKIX, localname, remotename, opts) if err != nil { log.Fatalf("initialize smtp to submission server: %v", err) } defer client.Close() // Send the message to the server, which will add it to its queue. req8bitmime := false // ASCII-only, so 8bitmime not required. reqSMTPUTF8 := false // No UTF-8 headers, so smtputf8 not required. requireTLS := false // Not supported by most servers at the time of writing. msg := "From: \r\nTo: \r\nSubject: hi\r\n\r\nnice to test you.\r\n" err = client.Deliver(ctx, "mjl@example.org", "other@example.com", int64(len(msg)), strings.NewReader(msg), req8bitmime, reqSMTPUTF8, requireTLS) if err != nil { log.Fatalf("submit message to smtp server: %v", err) } // Message has been submitted. }