emayili's Introduction

emayili

emayili is a package for sending emails from R. The design goals are:

works on all manner of SMTP servers and
has minimal dependencies (or dependencies which are easily satisfied).

The package name is an adaption of the Zulu word for email, imeyili.

Installation

At the moment you need to install the development version the {curl} package.

remotes::install_github("jeroen/curl")

Then install {emayili}.

remotes::install_github("datawookie/emayili")

Usage

First create a message object.

library(emayili)
library(magrittr)

email <- envelope()

Add addresses for the sender and recipient.

email <- email %>%
  from("[email protected]") %>%
  to("[email protected]") %>%
  cc("[email protected]")

There are also bcc() and reply() functions for setting the Bcc and Reply-To fields.

Add a subject.

email <- email %>% subject("This is a plain text message!")

Add a body.

email <- email %>% body("Hello!")

Add an attachment.

email <- email %>% attachment("image.jpg")

Create a SMTP server object and send the message.

smtp <- server(host = "smtp.gmail.com",
               port = 465,
               username = "[email protected]",
               password = "bd40ef6d4a9413de9c1318a65cbae5d7")
smtp(email, verbose = TRUE)

Using STARTTLS security protocol

If you’re trying to send email with a host that uses a STARTTLS security protocol (like Google Mail or Yahoo!), then it will most probably be blocked as it’s not enough secure. In order to circumvent this, you can grant access to less secure apps: