enthus1ast / nimMime

mime generator (email with attachments), no parser yet

mime - attach files to emails

Nim's standard library does not support attaching files to emails. This library provides you with the tools to do it.

---

1. Please note that this is a work in process.
2. Please give feedback how you would like to use a "mime.nim"

It implements "quoted printables" https://en.wikipedia.org/wiki/Quoted-printable and also introduces a MimeMessage object.

Example sending email with attachment:

import mime, smtp

## Compose your mime message
var
  file = newAttachment("<i am the file content>", "filename.txt", QUOTED_PRINTABLES)
  file2 = newAttachment("<i am another file content>", "filename2.txt", BASE64)
  pdf = newAttachment(readFile("important.pdf"), filename = "important.pdf")

pdf.encodeQuotedPrintables()

var email = newEmail("Hello friend", "Iñtërnâtiônàlizætiøn☃💩", "[e-mail]", @["[e-mail]"], attachments = @[file,file2,pdf])

## Send it using smtp.nim
var smtpConn = newSmtp(
  useSsl=true,
  debug=true
)
smtpConn.connect("myemailserver.loc", 587.Port)
smtpConn.auth("[e-mail]", "mypassword")
smtpConn.sendMail("[e-mail]",  @["[e-mail]"] , $email.finalize())
smtpConn.close()

Example sending email with body and attachment:

import mime, smtp

const smtpAddress = "mailserver.com"
const smtpPort = 465
const smtpUser  = "123456"
const smtpPassword = "pass"
const smtpFrom = "[e-mail]"

var multi = newMimeMessage()

# Main data
multi.body = "In multipart messages this is just a comment for incompatible clients"
multi.header["to"] = @["[e-mail]"].mimeList
multi.header["subject"] = "Email subject"

# Add text to email body
var first = newMimeMessage()
first.header["Content-Type"] = "text/plain"
first.body = "I show up in the email!"
multi.parts.add first

# Add attachement
var image = newAttachment(readFile("tests/logo.png"), filename = "logo.png")
image.encodeQuotedPrintables()
multi.parts.add image

# Send it using smtp.nim
var smtpConn = newSmtp(
  useSsl=true,
  debug=true
)
smtpConn.connect(smtpAddress, smtpPort.Port)
smtpConn.auth(smtpUser, smtpPassword)
smtpConn.sendMail(smtpFrom,  @["[e-mail]"], $multi.finalize())
smtpConn.close()

A multipart example of an email could look like:

for name in @["hans", "peter"]:
  var envelope = newMimeMessage()
  envelope.header["to"] = name & "@example.org"
  envelope.header["cc"] = @["[e-mail]", "[e-mail]"].mimeList()
  envelope.header["subject"] = mimeEncoder("Iñtërnâtiônàlizætiøn☃💩", QUOTED_PRINTABLES, true)

  # in multipart the body just contains a warning
  envelope.body = "Warning to old clients: This is a multipart MIME message! "

  var msg = newMimeMessage()
  # in multipart first part is normally displayed by mail agents.
  msg.body = "Dear $# ..." % @[name]
  envelope.parts.add msg # adding to parts turns the message into multipart.

  # newAttachement returns a prefilled MimeMessage
  if name == "hans": # only hans gets an attachment
    var forhans = newAttachment("<content of image.png>", "image.png", BASE64)
    envelope.parts.add forhans

    var anotherforhans = newAttachment("<content of image.png>", "image.png", QUOTED_PRINTABLES)
    envelope.parts.add anotherforhans
  envelope.finalize() # computes boundary etc...
  echo $envelope
  echo "===================================================="