Hedwig is a Swift package which supplies a set of high level APIs to allow you sending email to an SMTP server easily. If you are planning to send emails from your next amazing Swift server app, Hedwig might be a good choice.

Features

[x] Connect to all SMTP servers, through whether plain, SSL or TLS (STARTTLS) port.
[x] Authentication with PLAIN, CRAM-MD5, LOGIN or XOAUTH2.
[x] Send email with HTML body and attachments.
[x] Customize validation method and mail header, to track your mail campaign.
[x] Queued mail sending, without blocking your app. You can even send mails concurrently.
[x] Works with Swift Package Manager, in the latest Swift syntax and cross-platform.
[x] Fully tested and documented.

Installation

Add the url of this repo to your Package.swift:

import PackageDescription

let package = Package(
    name: "YourAwesomeSoftware",
    dependencies: [
        .Package(url: "https://github.com/onevcat/Hedwig.git", 
                 majorVersion: 1)
    ]
)

Then run swift build whenever you get prepared. (Also remember to grab a cup of coffee 😄)

You can find more information on how to use Swift Package Manager in Apple's official page.

Usage

Sending text only email

let hedwig = Hedwig(hostName: "smtp.example.com", user: "[email protected]", password: "password")
let mail = Mail(
        text: "Across the great wall we can reach every corner in the world.", 
        from: "[email protected]", 
        to: "[email protected]", 
        subject: "Hello World"
)
    
hedwig.send(mail) { error in
    if error != nil { /* Error happened */ }
}

Sending HTML email

let hedwig = Hedwig(hostName: "smtp.example.com", user: "[email protected]", password: "password")
let attachment = Attachment(htmlContent: "<html><body><h1>Title</h1><p>Content</p></body></html>")
let mail = Mail(
        text: "Fallback text", 
        from: "[email protected]", 
        to: "[email protected]", 
        subject: "Title", 
        attachments: [attachment]
)
hedwig.send(mail) { error in
    if error != nil { /* Error happened */ }
}

CC and BCC

let hedwig = Hedwig(hostName: "smtp.example.com", user: "[email protected]", password: "password")
let mail = Mail(
        text: "Across the great wall we can reach every corner in the world.", 
        from: "[email protected]", 
        to: "[email protected]",
        cc: "Wei Wang <[email protected]>, [email protected]", // Addresses will be parsed for you
        bcc: "My Group: [email protected], [email protected];",    // Even with group syntax
        subject: "Hello World"
)
hedwig.send(mail) { error in
    if error != nil { /* Error happened */ }
}

Using different SMTP settings (security layer, auth method and etc.)

let hedwig = Hedwig(
        hostName: "smtp.example.com", 
        user: "[email protected]", 
        password: "password",
        port: 1234,     // Determined from secure layer by default
        secure: .plain, // .plain (Port 25) | .ssl (Port 465) | .tls (Port 587) (default)
        validation: .default, // You can set your own certificate/cipher/protocols
        domainName: "onevcat.com", // Used when saying hello to STMP Server
        authMethods: [.plain, .login] // Default: [.plain, .cramMD5, .login, .xOauth2]        
)

Send mails with inline image and other attachment

let imagePath = "/tmp/image.png"
// You can create an attachment from a local file path.
let imageAttachment = Attachment(
        filePath: imagePath, 
        inline: true, 
        // Add "Content-ID" if you need to embed this image to another attachment.
        additionalHeaders: ["Content-ID": "hedwig-image"] 
)
let html = Attachment(
        htmlContent: "<html><body>A photo <img src=\"cid:hedwig-image\"/></body></html>", 
        // If imageAttachment only used embeded in HTML, I recommend to set it as related.
        related: [imageAttachment]
)

// You can also create attachment from raw data.
let data = "{\"key\": \"hello world\"}".data(using: .utf8)!
let json = Attachment(
        data: data, 
        mime: "application/json", 
        name: "file.json", 
        inline: false // Send as standalone attachment.
)

let mail = Mail(
        text: "Fallback text", 
        from: "[email protected]", 
        to: "[email protected]", 
        subject: "Check the photo and json file!",
        attachments: [html, json]
hedwig.send(mail) { error in
    if error != nil { /* Error happened */ }
}

Send multiple mails

let mail1: Mail = //...
let mail2: Mail = //...

hedwig.send([mail1, mail2], 
        progress: { (mail, error) in
            if error != nil { 
                print("\(mail) failed. Error: \(error)") 
            }
        },
        completion: { (sent, failed) in
            for mail in sent {
                print("Sent mail: \(mail.messageId)")
            }
            
            for (mail, error) in failed {
                print("Mail \(mail.messageId) errored: \(error)")
            }
        }
)

Help and Questions

Visit the documentation page for full API reference.

You could also run the tests (swift test) to see more examples to know how to use Hedwig.

If you have found the framework to be useful, please consider a donation. Your kind contribution will help me afford more time on the project.

Or you are a Bitcoin fan and want to treat me a cup of coffe, here is my wallet address:

1MqwfsxBJ5pJX4Qd2sRVhK3dKTQrWYooG5

FAQ

I cannot send mails with Gmail SMTP.

Gmail uses an application specific password. You need to create one and use the specified password when auth. See this.

I need to add/set some additonal header in the mail.

Both Mail and Attachment accept customizing header fields. Pass your headers as additionalHeaders when creating the mail or attachment and Hedwig will handle it.

Can I use it in iOS?

At this time Swift Package Manager has no support for iOS, watchOS, or tvOS platforms. So the answer is no. But this framework is not using anything only in iOS (like UIKit), so as soon as Swift Package Manager supports iOS, you can use it there too.

Tell me about the name and logo of Hedwig

Yes, Hedwig (bird) was Harry Potter's pet Snowy Owl. The logo of Hedwig (this framework) is created by myself and it pays reverence to the novels and movies.

Enjoy sending your emails

License

Hedwig is released under the MIT license. See LICENSE for details.

Project Name	Stars	Repos Using This	Packages Using This	Most Recent Commit	Total Releases	Latest Release	Open Issues	License	Language
Mailinabox	12,112			21 hours ago			504	cc0-1.0	Python
Mail-in-a-Box helps individuals take back control of their email by defining a one-click, easy-to-deploy SMTP+everything else server: a mail server in a box.
Mailhog	12,015			14 days ago	18	September 29, 2021	236	mit	Go
Web and API based SMTP testing
Mailcatcher	5,910	1,518	16	2 months ago	50	July 04, 2022	38	mit	Ruby
Catches mail and serves it through a dream.
Mailu	4,596			a day ago			130	other	Python
Insular email distribution - mail server as Docker images
Maddy	3,968		1	5 days ago	40	July 01, 2022	85	gpl-3.0	Go
✉️ Composable all-in-one mail server.
Papercut Smtp	2,546			2 months ago			38		JavaScript
Papercut SMTP -- The Simple Desktop Email Server
Smtp4dev	2,241	1	1	3 months ago	69	January 07, 2021	69	bsd-3-clause	C#
smtp4dev - the fake smtp email server for development and testing
Padloc	2,192		1	2 months ago	1	November 14, 2019	70	agpl-3.0	JavaScript
A modern, open source password manager for individuals and teams.
Go Guerrilla	2,146	1	8	2 years ago	2	December 28, 2019	55	mit	Go
Mini SMTP server written in golang
Go Imap	1,784	32	81	9 days ago	30	May 01, 2022	29	mit	Go
:inbox_tray: An IMAP library for clients and servers

Hedwig