ruslandoga / mua

Minimal SMTP client in Elixir

Mua

Minimal SMTP client (aka Mail user agent).

Can be used with Bamboo and Swoosh.

Features

• Direct messaging (no relays)
• Inderect messaging (relays)
• Minimal API
• Processless

Installation

defp deps do
  [
    {:mua, "~> 0.1.0"}
  ]
end

Usage

This demo will use MailHog:

$ docker run -d --rm -p 1025:1025 -p 8025:8025 --name mailhog mailhog/mailhog
$ open http://localhost:8025

High-level API:

message = """
Date: Mon, 25 Dec 2023 06:52:15 +0000\r
From: Mua <[e-mail]>\r
Subject: README\r
To: Mr Receiver <[e-mail]>\r
CC: Ms Receiver <[e-mail]>\r
\r
like and subscribe\r
.\r
"""

{:ok, _receipt} =
  Mua.easy_send(
    _host = "localhost",
    _mail_from = "[e-mail]",
    _rcpt_to = ["[e-mail]", "[e-mail]"],
    message,
    port: 1025,
    auth: [username: "username", password: "password"] 
  )

Low-level API:

{:ok, socket, _banner} = Mua.connect(:tcp, "localhost", _port = 1025)
{:ok, extensions} = Mua.ehlo(socket, _sending_domain = "github.com")

{:ok, socket} = 
  if "STARTTLS" in extensions do
    Mua.starttls(socket, "localhost")
  else
    {:ok, _stay_plain_text = socket}
  end

:plain = Mua.pick_auth_method(extensions)
:ok = Mua.auth(socket, :plain, username: "username", password: "password")

:ok = Mua.mail_from(socket, "[e-mail]")
:ok = Mua.rcpt_to(socket, "[e-mail]")

message =
  """
  Date: Mon, 25 Dec 2023 06:52:15 +0000\r
  From: Mua <[e-mail]>\r
  Subject: How was your day?\r
  To: Mr Receiver <[e-mail]>\r
  \r
  Mine was fine.\r
  .\r
  """

{:ok, _receipt} = Mua.data(socket, message)
:ok = Mua.close(socket)