@return [EmailAddressCollection] Returns a collection that represents

all of the verified email addresses for your account.

# File lib/aws/simple_email_service.rb, line 150
def email_addresses
  EmailAddressCollection.new(:config => config)
end

@example

ses.quotas
# {:max_24_hour_send=>200, :max_send_rate=>1.0, :sent_last_24_hours=>22}

@return [Hash] Returns a hash of SES quotas and limits.

# File lib/aws/simple_email_service.rb, line 317
def quotas
  Quotas.new(:config => config).to_h
end

Sends an email.

ses.send_email(
  :subject => 'A Sample Email',
  :to => 'john@doe.com', 
  :from => 'no@reply.com',
  :body_text => 'sample text ...',
  :body_html => '<p>sample text ...</p>')

You can also pass multiple email addresses for the :to, :cc, :bcc and :reply_to options. Email addresses can also be formatted with names.

ses.send_email(
  :subject => 'A Sample Email',
  :to => ['"John Doe" <john@doe.com>', '"Jane Doe" <jane@doe.com>'],
  :from => 'no@reply.com',
  :body_text => 'sample text ...')

@param [Hash] options @option options [required,String] :subject The subject of the message.

A short summary of the content, which will appear in the #
recipient's inbox.

@option options [required,String] :from The sender’s email address. @option options [String,Array] :to The address(es) to send the email to. @option options [String,Array] :cc The address(es) to cc (carbon copy)

the email to.

@option options [String,Array] :bcc The address(es) to bcc (blind

carbon copy) the email to.

@option options [String,Array] :reply_to The reply-to email address(es)

for the message. If the recipient replies to the message, each 
reply-to address will receive the reply.

@option options [String] :return_path The email address to which

bounce notifications are to be forwarded. If the message cannot be
delivered to the recipient, then an error message will be returned
from the recipient's ISP; this message will then be forwarded to
the email address specified by the +:return_path+ option.

@option options [String] :body_text The email text contents.

You must provide +:body_text+, +:body_html+ or both.

@option options [String] :body_html The email html contents.

You must provide +:body_text+, +:body_html+ or both.

@option options [String] :subject_charset The character set of the

+:subject+ string.  If the text must contain any other characters,
then you must also specify the character set. Examples include 
UTF-8, ISO-8859-1, and Shift_JIS. Defaults to 7-bit ASCII.

@option options [String] :body_text_charset The character set of the

+:body_text+ string.  If the text must contain any other characters,
then you must also specify the character set. Examples include 
UTF-8, ISO-8859-1, and Shift_JIS. Defaults to 7-bit ASCII.

@option options [String] :body_html_charset The character set of the

+:body_html+ string.  If the text must contain any other characters,
then you must also specify the character set. Examples include 
UTF-8, ISO-8859-1, and Shift_JIS. Defaults to 7-bit ASCII.

@option options [String] :body_html @return [nil]

# File lib/aws/simple_email_service.rb, line 209
def send_email options = {}

    require_each(options, :subject, :from)
    require_one_of(options, :to, :cc, :bcc)
    require_one_of(options, :body_text, :body_html)

  # these three options can be passed strings or arrays of strings,
  # but the service requires them in a list (array)
  [:to, :cc, :bcc, :reply_to].each do |key|
    if options[key]
      options[key] = [options[key]].flatten
    end
  end

  accepted_options = {
    :subject           => %w(message subject data),
    :subject_charset   => %w(message subject charset),
    :to                => %w(destination to_addresses),
    :cc                => %w(destination cc_addresses),
    :bcc               => %w(destination bcc_addresses),
    :from              => %w(source),
    :reply_to          => %w(reply_to_addresses),
    :return_path       => %w(return_path),
    :body_text         => %w(message body text data),
    :body_text_charset => %w(message body text charset),
    :body_html         => %w(message body html data),
    :body_html_charset => %w(message body html charset),
  }

  client.send_email(nest_options(options, accepted_options))
  nil

end

Sends a raw email (email message, with header and content specified). Useful for sending multipart MIME emails. The raw text of the message must comply with Internet email standards; otherwise, the message cannot be sent.

raw = <<-EMAIL
Date: Wed, 1 Jun 2011 09:13:07 -0700
Subject: A Sample Email
From: "John Doe" <johndoe@domain.com>
To: "Jane Doe" <janedoe@domain.com>
Accept-Language: en-US
Content-Language: en-US
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: base64
MIME-Version: 1.0

c2FtcGxlIHRleHQNCg==
EMAIL

ses.send_raw_email(raw)

Amazon SES has a limit on the total number of recipients per message: The combined number of To:, CC: and BCC: email addresses cannot exceed 50. If you need to send an email message to a larger audience, you can divide your recipient list into groups of 50 or fewer, and then call Amazon SES repeatedly to send the message to each group.

@param [required, String] raw_message The raw text of the message.

You can pass in any object whos #to_s returns a valid formatted
email (e.g. ruby Mail gem).  The raw message should:
* Contain a header and a body, separated by a blank line
* Contain all required internet email headers
* Each part of a multipart MIME message must be formatted properly
* MIME content types must be among those supported by Amazon SES. 
  Refer to the Amazon SES Developer Guide for more details.
* Use content that is base64-encoded, if MIME requires it

@option options [String,Array] :to One or more email addresses to

send the email to.

@option options [String] :from The sender’s email address.

If you specify the :from option, then bounce notifications and 
complaints will be sent to this email address. This takes 
precedence over any Return-Path header that you might include in 
the +raw_message+.

@return [nil]

# File lib/aws/simple_email_service.rb, line 288
def send_raw_email raw_message, options = {}

  send_opts = {}
  send_opts[:raw_message] = {}
  send_opts[:raw_message][:data] = raw_message.to_s
  
  if raw_message.class.name == 'Mail::Message'
    send_opts[:source] = raw_message.from.first
    send_opts[:destinations] = raw_message.destinations
  else
    send_opts[:source] = options[:from] if options[:from]
    send_opts[:destinations] = [options[:to]].flatten if options[:to]
  end

  client.send_raw_email(send_opts)
  nil

end

Returns an array of email statistics. Each object in this array is a hash with the following keys:

• :delivery_attempts

• :rejects

• :bounces

• :complaints

• :timestamp

@return [Array of Hashes] An array of email statistic hashes.

# File lib/aws/simple_email_service.rb, line 331
def statistics
  client.get_send_statistics.send_data_points.inject([]) do |stats, data|
    stats << {
      :sent => data.timestamp,
      :delivery_attempts => data.delivery_attempts,
      :rejects => data.rejects,
      :bounces => data.bounces,
      :complaints => data.complaints,
    }
  end
end

@private

# File lib/aws/simple_email_service.rb, line 364
def nest_options options, accepted_options

  send_opts = {}
  accepted_options.each_pair do |option, keys|
    next unless options[option]
    hash = send_opts
    keys.collect{|k| k.to_sym }.each do |key|
      hash[key] = {} unless hash[key]
      if keys.last == key.to_s
        hash[key] = options[option]
      else
        hash = hash[key]
      end
    end
  end

  send_opts
end

@private

# File lib/aws/simple_email_service.rb, line 354
def require_each options, *keys
  keys.each do |key|
    unless options[key]
      raise ArgumentError, "missing required option :#{key}"
    end
  end
end

@private

# File lib/aws/simple_email_service.rb, line 345
def require_one_of options, *keys
  unless keys.any?{|key| options[key] }
    parts = keys.collect{|key| ":#{key}" }.join(', ')
    raise ArgumentError, "you must provide at least one of #{parts}" 
  end
end