smtp 0.2.0

Synchronous SMTP library for D language


To use this package, run the following command in your project's root directory:

Manual usage
Put the following dependency into your project's dependences section:

SMTP library for D - version 0.1.1

Native synchronous SMTP client implementation in D language. Get at official Dub repository: code.dlang.org

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 (ssl version only)
  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
  • LOGIN

TODO

  1. More authentication methods.
  2. More Dedicated clients for popular mail providers, additional API simplification.
  3. Unit-tests suite.
  4. 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.1.1",
       }
     }
    
  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.
  3. sender Shows how to authenticate and send a message using high-level API via MailSender class: connect, authenticate, send methods. MailSender high-level methods provide thread-safety.

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. Obviously this works with ssl configuration of smtp library only.

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

Authors:
  • Rostyslav Dzinko
Dependencies:
none
Versions:
0.3.0 2015-Jul-17
0.2.1 2015-Jul-15
0.2.0 2014-Apr-22
0.1.1 2014-Apr-12
0.1.0 2014-Apr-12
Show all 11 versions
Download Stats:
  • 0 downloads today

  • 0 downloads this week

  • 0 downloads this month

  • 11258 downloads total

Score:
1.2
Short URL:
smtp.dub.pm