smtp 0.1.0

SMTP library for D - v0.0.9

Native SMTP client implementation in D language. Get at: Dub registry

Tested with:

• gdc-4.8 dmd-2.065.0 on Ubuntu 13.10
• dmd-2.065.0 on OS X 10.9.2

Features

1. SmtpClient class that implements SMTP client (mostly low-level functions)
2. MailSender class that implements simplified API
3. GMailSender is a MailSender predefined to use GMail's smtp gateway
4. SmtpMessage class that implements SMTP message fields storage
5. SSL/TLS encryption support (via OpenSSL). Next encryption methods implemented:

• SSLv2
• SSLv23
• SSLv3
• TLSv1

1. Authentication support which includes the next methods:

• PLAIN

TODO

1. More authentication methods.
2. More Dedicated clients for popular mail providers, additional API simplification.
3. Thread-safety.
4. High-level client.
5. Unit-tests suite.
6. Asynchronous version (based on fibers?)

Installation

You can use smtp library for D via dub package manager. For this, follow the next steps:

1. Download dub from DLang site (if you still don't have it installed).
2. Create your project (or use dub.json from your existing one).
3. Add smtp as a dependency:

    {
      "dependencies": {
      		"smtp": ">=0.0.3",
      }
    }
   

4. Use dub to build smtp library:

   without SSL/TLS support

    $ dub
   

   or with SSL/TLS support:

    $ dub -c ssl
   

   To chose right smtp building configuration for your project use subConfigurations setting in your project's dub.json:

    {
      "subConfigurations": { "smtp": "no-ssl" }
    }
   

   Available configurations are:

   • no-ssl by default
   • ssl to build with OpenSSL support

Usage

You can find low-level API usage example projects in examples folder:

1. lowlevel Shows the simplest chain of routines to send e-mail message via unencrypted channel.

2. lowlevel-tls Shows the simplest chain of routines to send e-mail message via encrypted channel.

You can enter folder examples/<example-project-name> and perform $ dub in order to run and test example.

If you're a Linux or OS X user, you can use standard sendmail utility to get SMTP server up and running on your local host. For that just open new terminal tab or window and type sendmail.

If you want to test encrypted client, you can use smtp.gmail.com:587 along with TLSv1 encryption method.

Here's an example of high-level SmtpClient API usage for sending sample email either using open or encrypted channel.