https://github.com/enricoschumann/mailtools
R utilities for handling email
https://github.com/enricoschumann/mailtools
email outlook sendemail
Last synced: 8 months ago
JSON representation
R utilities for handling email
- Host: GitHub
- URL: https://github.com/enricoschumann/mailtools
- Owner: enricoschumann
- Created: 2017-08-31T18:26:44.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2023-10-27T14:35:38.000Z (over 2 years ago)
- Last Synced: 2025-02-24T08:19:21.743Z (over 1 year ago)
- Topics: email, outlook, sendemail
- Language: R
- Homepage:
- Size: 30.3 KB
- Stars: 3
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.org
- Changelog: ChangeLog
Awesome Lists containing this project
README
#+TITLE: mailtools
#+AUTHOR: Enrico Schumann
* Usage: Sending Emails
A typical call may look as follows.
#+BEGIN_SRC R :eval never
library("mailtools")
sendmail(subject = "Greetings",
body = "Hello",
to = "testing@testing.org",
from = "",
port = 123,
server = "my-magic-server.net",
user = "username",
password = "1234.password",
headers = "X-GREETINGS-CATEGORY: hello",
method = c(unix = "sendemail",
windows = "blat")[.Platform$OS.type])
#+END_SRC
On Windows, you may prefer method =outlook= (which
requires Outlook and PowerShell installed).
#+BEGIN_SRC R :eval never
sendmail(subject = "Greetings",
body = "Hello",
to = "testing@testing.org",
method = "outlook",
display.only = TRUE) ## only open mail in Outlook
#+END_SRC
Formating message texts is possible via HTML.
(Note that R supports multi-line strings.)
#+BEGIN_SRC R :eval never
body <- "
Hello.
Please do not send spam.
"
sendmail(subject = "Greetings",
body = body,
to = "testing@testing.org",
method = "outlook",
html = TRUE,
display.only = TRUE)
#+END_SRC
(But note that none of the backends will automatically
create a text part for your message. In the good old
days, a message with an HTML part but no text part was
often more likely to be flagged as spam. But these
days it seems to be the norm. Oh well. You have been
warned, in any case.)
* Installation
The latest version of the package is available from
[[http://enricoschumann.net/R/packages/mailtools]]. You can
install the package directly from within R:
#+BEGIN_SRC R :eval never
install.packages('mailtools',
repos = c('http://enricoschumann.net/R',
getOption('repos')))
#+END_SRC
Note that the package itself does not provide code for
actually sending emails. For this, you'll need a
backend.
On GNU/Linux systems, there is support for [[http://caspian.dotconf.net/menu/Software/SendEmail][=sendemail=]].
On Debian/Ubuntu systems, for instance, it is easily
installed:
#+BEGIN_SRC sh :eval never
sudo apt install sendemail
#+END_SRC
On Windows, the preferred backend is [[https://www.blat.net/][Blat]].
Alternatively, provided PowerShell is installed (which
is the default case on newer Windows systems), you may
use Outlook.
There is also a publicly-available repository at
https://github.com/enricoschumann/mailtools.