aboutsummaryrefslogtreecommitdiff
path: root/butl/sendmail
blob: 5a380e72ab00d5190b49fe78b81393560d95364e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
// file      : butl/sendmail -*- C++ -*-
// copyright : Copyright (c) 2014-2017 Code Synthesis Ltd
// license   : MIT; see accompanying LICENSE file

#ifndef BUTL_SENDMAIL
#define BUTL_SENDMAIL

#include <string>

#include <butl/export>

#include <butl/process>
#include <butl/fdstream>
#include <butl/small-vector>

namespace butl
{
  // Send email using the sendmail program.
  //
  // Write the body of the email to out. Note that you must explicitly close
  // it before calling wait(). Throw process_error and io_error (both derive
  // from system_error) in case of errors.
  //
  // Typical usage:
  //
  // try
  // {
  //   sendmail sm (2,                    // Diagnostics to stderr.
  //                "",                   // Default From: address.
  //                "Test subject",
  //                {"test@example.com"});
  //
  //   sm.out << "Test body" << endl;
  //
  //   sm.close ();
  //
  //   if (!sm.wait ())
  //     ... // sendmail returned non-zero status.
  // }
  // catch (const std::system_error& e)
  // {
  //   cerr << "sendmail error: " << e << endl;
  // }
  //
  class LIBBUTL_EXPORT sendmail: public process
  {
  public:
    ofdstream out;

    // Notes:
    //
    // - If from is empty then the process user's address is used.
    //
    // - The to/cc/bcc addressed should already be quoted if required.
    //
    using recipients_type = small_vector<std::string, 1>;

    template <typename E, typename... O>
    sendmail (E&& err,
              const std::string& from,
              const std::string& subject,
              const recipients_type& to,
              const recipients_type& cc = recipients_type (),
              const recipients_type& bcc = recipients_type (),
              O&&... options);

    // Version with the command line callback (see process_run() for
    // details).
    //
    template <typename C, typename E, typename... O>
    sendmail (const C&,
              E&& err,
              const std::string& from,
              const std::string& subject,
              const recipients_type& to,
              const recipients_type& cc = recipients_type (),
              const recipients_type& bcc = recipients_type (),
              O&&... options);

  private:
    void
    headers (const std::string& from,
             const std::string& subj,
             const recipients_type& to,
             const recipients_type& cc,
             const recipients_type& bcc);
  };
}

#include <butl/sendmail.ixx>

#endif // BUTL_SENDMAIL