gulp-mail

gulp-mail

A gulp wrapper for Nodemailer used to quickly send emails from tasks and/or the command-line during development or testing.

gulp-mail is based on gulp-mailer, which is not available on npm.

Installation

Installing via npm:

npm install --save-dev gulp-mail

Usage

mail(options)

• options: Object

Options

gulp-mail uses Nodemailer v0.7.1, which has been deprecated for some time. It is, however, simple and stable. Available options for gulp-mail are:

options.smtp

Type: Object
Contains required SMTP configuration values. (See the example below.)

options.to

Type: String|Array
A string or array containing one or more than one recipient address, respectively.

options.from

Type: String
The display name for the sender.

options.subject

Type: String
The email subject line. If not provided, a default subject line is generated from the source filename as [TEST] path.basename.

options.html

Type: String
The HTML body of the email. If not provided, the source file becomes the message body.

options.text

Type: String
The plaintext body of the email. If not provided, Nodemailer generates this based on the source file.

Example

Currently, gulp-mail takes in piped streams and sends emails via SMTP only.

var gulp = require('gulp');
var mail = require('gulp-mail');

var smtpInfo = {
  auth: {
    user: 'foo@163.com',
    pass: '123456'
  },
  host: 'smtp.163.com',
  secureConnection: true,
  port: 465
};

gulp.task('mail', function () {
  return gulp.src('./mails/i-love-you.html')
    .pipe(mail({
      subject: 'Surprise!?',
      to: [
        'bar@gmail.com'
      ],
      from: 'Foo <foo@163.com>',
      smtp: smtpInfo
    }));
});