smtp – Clojure docs and tutorials

As mentioned in my other post about plaintext emails, I recommend using the Apache Commons Email library when sending email from Clojure apps. First up, you need to add the dependency to ‘project.clj’

  :dependencies [
                 [org.clojure/clojure "1.10.1"]
                 [org.apache.commons/commons-email "1.5"]
                 ]

:dependencies [

[org.clojure/clojure "1.10.1"]

[org.apache.commons/commons-email "1.5"]

]

Next, your HTML email has both an HTML version and the alternative plaintext version of the email. Notice, all you have to do is create an instance of HtmlEmail and then call the set and send methods on it using ‘doto’. Pretty easy.

(ns email-example.core
  (:import (org.apache.commons.mail HtmlEmail)))

(defn -main
  "I don't do a whole lot ... yet."
  [& args]
  (println "Email the World ...")

   (let [smtp-address "smtp.example.com"
         from "me@example.com"
         to "you@example.com"
         subject "Test email"
         msg-html "<html>This is your basic html text email.<br>Enjoy!</html>"
         msg-plain "This is your basic alternate plain text email.\nEnjoy!"]

    (doto (HtmlEmail.)
      (.setHostName smtp-address)
      (.setFrom from)
      (.setSubject subject)
      (.addTo to)
      (.setHtmlMsg msg-html)
      (.setTextMsg msg-plain)
      (.send)))

  (println "... Email Sent!"))

(ns email-example.core

(:import (org.apache.commons.mail HtmlEmail)))

(defn -main

"I don't do a whole lot ... yet."

[& args]

(println "Email the World ...")

(let [smtp-address "smtp.example.com"

from "[email protected]"

to "[email protected]"

subject "Test email"

msg-html "<html>This is your basic html text email.<br>Enjoy!</html>"

msg-plain "This is your basic alternate plain text email.\nEnjoy!"]

(doto (HtmlEmail.)

(.setHostName smtp-address)

(.setFrom from)

(.setSubject subject)

(.addTo to)

(.setHtmlMsg msg-html)

(.setTextMsg msg-plain)

(.send)))

(println "... Email Sent!"))

There are more examples and the javadocs over at the Apache Commons site. However, this should be a basic enough example to get you started.

I recommend using the Apache Commons Email library when sending email from Clojure apps. Here’s a simple example.

First up, you need to add the dependency to ‘project.clj’

  :dependencies [
                 [org.clojure/clojure "1.10.1"]
                 [org.apache.commons/commons-email "1.5"]
                 ]

:dependencies [

[org.clojure/clojure "1.10.1"]

[org.apache.commons/commons-email "1.5"]

]

Next, your code would look something like the following. Caution, … This will send emails, so configure it to send the emails to a personal email address for testing purposes.

(ns email-example.core
  (:import (org.apache.commons.mail SimpleEmail)))

(defn -main
  "I send plaintext emails using the Apache Commons Email library."
  [& args]
  (println "Email the World ...")

  ;; for more methods, such as for authentication, look at the manual...
  ;; http://commons.apache.org/proper/commons-email/userguide.html

  (let [smtp-address "smtp.example.com"
         from "my@example.com"
         to "your@example.com"
         subject "Test email"
         msg "This is your basic plain text email. Enjoy!"]

    (doto (SimpleEmail.)
      (.setHostName smtp-address)
      (.setFrom from)
      (.setSubject subject)
      (.setMsg msg)
      (.addTo to)
      (.send)))

  (println "... Email Sent!"))

(ns email-example.core

(:import (org.apache.commons.mail SimpleEmail)))

(defn -main

"I send plaintext emails using the Apache Commons Email library."

[& args]

(println "Email the World ...")

;; for more methods, such as for authentication, look at the manual...

;; http://commons.apache.org/proper/commons-email/userguide.html

(let [smtp-address "smtp.example.com"

from "[email protected]"

to "[email protected]"

subject "Test email"

msg "This is your basic plain text email. Enjoy!"]

(doto (SimpleEmail.)

(.setHostName smtp-address)

(.setFrom from)

(.setSubject subject)

(.setMsg msg)

(.addTo to)

(.send)))

(println "... Email Sent!"))

Apache License

Copyright 2020 T Gene Davis

Licensed under the Apache License, Version 2.0 (the "License"); you may not use code on this website except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Authors of code and quotes used with permission are owned by the original authors. T Gene Davis makes no claims of ownership of their code and quotes.

Tag: smtp

HTML Email from Clojure

Plain Text Email from Clojure