package sendmail-lwt

  1. Overview
  2. Docs
Implementation of the sendmail command over LWT

Install

Dune Dependency

Authors

Maintainers

Sources

colombe-0.7.0.tbz
sha256=6dcf2b125140de0ac956b6930226b2546be53bb33248783270e477d5463b58e6
sha512=c1db3b96657be97469627b6e1bf7d9ddcd088957056d8aea1c8a0cad0750a37de9749dafa7479c86d1f6a92fd660a1a8f6fca6fa8a48a4e2c75ebc48edb910c3

Description

A library to be able to send an email with LWT and TLS.

Published: 30 Nov 2022

README

Colombe - an implementation of SMTP protocol in OCaml

colombe is a little library which wants to implement the SMTP protocol according RFC5321. It is a low-level library used by some others projects to implements clients or servers.

The library does not handle properly an email. If you want to generate a proper email or introspect an email, you should be interested by mrmime.

As a client

The distribution provides sendmail, sendmail.starttls and sendmail-lwt which are respectively:

  • An agnostic (to the system) implementation of an usual client with authentication

  • An agnostic (to the system) implementation of an usual client with authentication and STARTTLS extension

  • An LWT implementation of an usual client with authentication

Depending on your context:

  • If you want to communicate with a SMTP server which require a TLS connection (like, *:465), sendmail with a scheduler such as LWT or ASYNC (or UNIX) should be use. sendmail-lwt is a specialization with LWT.

  • If you want to communicate with a SMTP server which handles (and surely requires) STARTTLS extension, (like *:587), sendmail.starttls with a scheduler should be use.

Of course, a client can be more complex and can handle:

  • file attachments

  • a well formed email

  • some usual metadata such as the timezone

If you are interested by that, you should look into facteur which wants to provide a little binary to send an email with a nice use between colombe, mrmime and some others MirageOS projects.

As a server

Of course, colombe implements both sides. By this library, you are able to implement an SMTP server - if you are interested by that, you should look into ptt.

How to use colombe

As we said, the library wants to be a low-level one. At least, the core does not handle properly eSMTP extensions or any high mechanisms such the authentication. It's mostly because the library wants to be used by a server implementation and a client implementation.

It only ensures a high abstracted interface on top of the low-level of the communication. The library defines only few parts of the SMTP protocol and a monadic interface to describe the state-machine while the communication with an other peer.

sendmail is a good example about how to use colombe. It describes structurally the SMTP protocol (only what it really needs) and the state machine to send an email.

Received field

RFC5321 describes the SMTP protocols and some mechanisms such as the Received: field. The distribution provides a way to introspect Received: fields (and can produce a graph of them) or generate them from a server configuration.

Credits

colombe has received funding from the Next Generation Internet Initiative (NGI) within the framework of the DAPSI Project.

Dependencies (7)

  1. x509 >= "0.12.0"
  2. tls >= "0.13.0" & < "0.16.0"
  3. lwt
  4. domain-name
  5. sendmail = version
  6. dune >= "2.0"
  7. ocaml >= "4.03.0"

Dev Dependencies (1)

  1. alcotest with-test

Used by (2)

  1. facteur
  2. letters >= "0.1.1" & < "0.2.1"

Conflicts

None