aws-ses 0.4.1 → 0.4.2

data/CHANGELOG

@@ -1,3 +1,8 @@
+0.4.2:
+* Added support for ReplyToAddresses, Destinations, and Source (pzb)
+* Added custom User-Agent header (pzb)
+* Widespread doc updates
+
 0.4.1:
 * Removed many unneeded monkeypatch extensions
 * Tests ( and gem ) run in 1.9.2

data/README.erb

@@ -42,6 +42,24 @@ Then set the delivery method in `config/environments/*rb` as appropriate:
       ActionMailer::Base.delivery_method = :amazon_ses
       ActionMailer::Base.custom_amazon_ses_mailer = AWS::SES::Base.new(:secret_access_key => 'abc', :access_key_id => '123')
     end
+    
+== Issues
+
+=== HTTP Segmentation fault
+
+If you get this error:
+    net/http.rb:677: [BUG] Segmentation fault
+
+It means that you are not running with SSL enabled in ruby.  Re-compile ruby with ssl support or add this option to your environment:
+    RUBYOPT="-r openssl"
+    
+=== Rejected sending
+
+If you are receiving this message and you HAVE verified the [source] please <b>check to be sure you are not in sandbox mode!</b>
+    "Email address is not verified.MessageRejected (AWS::Error)"
+If you have not been granted production access, you will have to <b>verify all recipients</b> as well.
+  
+http://docs.amazonwebservices.com/ses/2010-12-01/DeveloperGuide/index.html?InitialSetup.Customer.html
 
 == Source
 
@@ -69,4 +87,6 @@ Special thanks to Marcel Molina Jr. for his creation of AWS::S3 which I used por
 
 * croaky
 * nathanbertram
-* sshaw
+* sshaw
+* teeparham (documentation)
+* pzb

data/README.rdoc

@@ -27,10 +27,15 @@ Use the following to send an e-mail:
 
   ses = AWS::SES::Base.new( ... connection info ... )
   ses.send_email :to        => ['jon@example.com', 'dave@example.com'],
-               :source    => 'steve@example.com',
+               :source    => '"Steve Smith" <steve@example.com>',
                :subject   => 'Subject Line'
                :text_body => 'Internal text body'
 
+By default, the email "from" display address is whatever is before the @. 
+To change the display from, use the format: 
+
+  "Steve Smith" <steve@example.com>
+
 You can also send Mail objects using send_raw_email:
 
   m = Mail.new( :to => ..., :from => ... )
@@ -39,6 +44,7 @@ You can also send Mail objects using send_raw_email:
 send_raw_email will also take a hash and pass it through Mail.new automatically as well.
 
 
+
 == Addresses
 
 AWS::SES::Addresses provides for:
@@ -71,7 +77,7 @@ You can access these methods as follows:
 == Get the quota information
   response = ses.quota
   # How many e-mails you've sent in the last 24 hours
-  response.send_last_24_hours
+  response.sent_last_24_hours
   # How many e-mails you're allowed to send in 24 hours
   response.max_24_hour_send
   # How many e-mails you can send per second
@@ -140,6 +146,24 @@ Then set the delivery method in `config/environments/*rb` as appropriate:
       ActionMailer::Base.delivery_method = :amazon_ses
       ActionMailer::Base.custom_amazon_ses_mailer = AWS::SES::Base.new(:secret_access_key => 'abc', :access_key_id => '123')
     end
+    
+== Issues
+
+=== HTTP Segmentation fault
+
+If you get this error:
+    net/http.rb:677: [BUG] Segmentation fault
+
+It means that you are not running with SSL enabled in ruby.  Re-compile ruby with ssl support or add this option to your environment:
+    RUBYOPT="-r openssl"
+    
+=== Rejected sending
+
+If you are receiving this message and you HAVE verified the [source] please <b>check to be sure you are not in sandbox mode!</b>
+    "Email address is not verified.MessageRejected (AWS::Error)"
+If you have not been granted production access, you will have to <b>verify all recipients</b> as well.
+  
+http://docs.amazonwebservices.com/ses/2010-12-01/DeveloperGuide/index.html?InitialSetup.Customer.html
 
 == Source
 
@@ -167,4 +191,6 @@ Special thanks to Marcel Molina Jr. for his creation of AWS::S3 which I used por
 
 * croaky
 * nathanbertram
-* sshaw
+* sshaw
+* teeparham (documentation)
+* pzb

data/VERSION

@@ -1 +1 @@
-0.4.1
+0.4.2

data/aws-ses.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{aws-ses}
-  s.version = "0.4.1"
+  s.version = "0.4.2"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Drew Blas", "Marcel Molina Jr."]
-  s.date = %q{2011-02-09}
+  s.date = %q{2011-03-11}
   s.description = %q{Client library for Amazon's Simple Email Service's REST API}
   s.email = %q{drew.blas@gmail.com}
   s.extra_rdoc_files = [
@@ -52,7 +52,7 @@ Gem::Specification.new do |s|
   s.homepage = %q{http://github.com/drewblas/aws-ses}
   s.licenses = ["MIT"]
   s.require_paths = ["lib"]
-  s.rubygems_version = %q{1.4.2}
+  s.rubygems_version = %q{1.5.2}
   s.summary = %q{Client library for Amazon's Simple Email Service's REST API}
   s.test_files = [
     "test/address_test.rb",

data/lib/aws/ses/base.rb

@@ -23,6 +23,8 @@ module AWS #:nodoc:
     
     DEFAULT_HOST = 'email.us-east-1.amazonaws.com'
     
+    USER_AGENT = 'github-aws-ses-ruby-gem'
+    
     # Encodes the given string with the secret_access_key by taking the
     # hmac-sha1 sum, and then base64 encoding it.  Optionally, it will also
     # url encode the result of that to protect the string if it's going to
@@ -66,6 +68,7 @@ module AWS #:nodoc:
       # @option options [Boolean] :use_ssl (true) Connect using SSL?
       # @option options [String] :server ("email.us-east-1.amazonaws.com") The server API endpoint host
       # @option options [String] :proxy_server (nil) An HTTP proxy server FQDN
+      # @option options [String] :user_agent ("github-aws-ses-ruby-gem") The HTTP User-Agent header value
       # @return [Object] the object.
       def initialize( options = {} )
 
@@ -74,6 +77,7 @@ module AWS #:nodoc:
                     :use_ssl => true,
                     :server => DEFAULT_HOST,
                     :path => "/",
+                    :user_agent => USER_AGENT,
                     :proxy_server => nil
                     }.merge(options)
 
@@ -81,6 +85,7 @@ module AWS #:nodoc:
         @proxy_server = options[:proxy_server]
         @use_ssl = options[:use_ssl]
         @path = options[:path]
+        @user_agent = options[:user_agent]
 
         raise ArgumentError, "No :access_key_id provided" if options[:access_key_id].nil? || options[:access_key_id].empty?
         raise ArgumentError, "No :secret_access_key provided" if options[:secret_access_key].nil? || options[:secret_access_key].empty?
@@ -147,7 +152,7 @@ module AWS #:nodoc:
 
         req['X-Amzn-Authorization'] = get_aws_auth_param(timestamp.httpdate, @secret_access_key)
         req['Date'] = timestamp.httpdate
-        req['User-Agent'] = "github-aws-ses-ruby-gem"
+        req['User-Agent'] = @user_agent 
 
         response = connection.post(@path, query, req)
         

data/lib/aws/ses/info.rb

@@ -9,7 +9,7 @@ module AWS
     # == Get the quota information
     #   response = ses.quota
     #   # How many e-mails you've sent in the last 24 hours
-    #   response.send_last_24_hours
+    #   response.sent_last_24_hours
     #   # How many e-mails you're allowed to send in 24 hours
     #   response.max_24_hour_send
     #   # How many e-mails you can send per second

data/lib/aws/ses/send_email.rb

@@ -5,16 +5,22 @@ module AWS
     #
     #   ses = AWS::SES::Base.new( ... connection info ... )
     #   ses.send_email :to        => ['jon@example.com', 'dave@example.com'],
-    #                :source    => 'steve@example.com',
+    #                :source    => '"Steve Smith" <steve@example.com>',
     #                :subject   => 'Subject Line'
     #                :text_body => 'Internal text body'
     #
+    # By default, the email "from" display address is whatever is before the @. 
+    # To change the display from, use the format: 
+    #
+    #   "Steve Smith" <steve@example.com>
+    #
     # You can also send Mail objects using send_raw_email:
     # 
     #   m = Mail.new( :to => ..., :from => ... )
     #   ses.send_raw_email(m)
     #
     # send_raw_email will also take a hash and pass it through Mail.new automatically as well.
+    #
     module SendEmail
       
       # Sends an email through SES
@@ -27,7 +33,7 @@ module AWS
       # ---
       # = "Email address is not verified.MessageRejected (AWS::Error)"
       # If you are receiving this message and you HAVE verified the [source] please <b>check to be sure you are not in sandbox mode!</b>
-      # If you have not been granted production access, you will have to <b>verify all recipients</b as well.
+      # If you have not been granted production access, you will have to <b>verify all recipients</b> as well.
       # http://docs.amazonwebservices.com/ses/2010-12-01/DeveloperGuide/index.html?InitialSetup.Customer.html
       # ---
       #
@@ -40,6 +46,7 @@ module AWS
       # @option options [String] :html_body
       # @option options [String] :text_body
       # @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 ReturnPath parameter.
+      # @option options [String] :reply_to The reploy-to email address(es) for the message.  If the recipient replies to the message, each reply-to address will receive the reply.
       # @option options
       # @return [Response] the response to sending this e-mail
       def send_email(options = {})
@@ -58,6 +65,8 @@ module AWS
         
         package['ReturnPath'] = options[:return_path] if options[:return_path]
         
+        add_array_to_hash!(package, 'ReplyToAddresses', options[:reply_to]) if options[:reply_to]
+        
         request('SendEmail', package)
       end
       
@@ -81,10 +90,21 @@ module AWS
       # @option mail [String] A raw string that is a properly formatted e-mail message
       # @option mail [Hash] A hash that will be parsed by Mail.new
       # @option mail [Mail] A mail object, ready to be encoded
+      # @option args [String] :source The sender's email address
+      # @option args [String] :destinations A list of destinations for the message.
+      # @option args [String] :from alias for :source
+      # @option args [String] :to alias for :destinations
       # @return [Response]
-      def send_raw_email(mail)
+      def send_raw_email(mail, args = {})
         message = mail.is_a?(Hash) ? Mail.new(mail).to_s : mail.to_s
         package = { 'RawMessage.Data' => Base64::encode64(message) }
+        package['Source'] = args[:from] if args[:from]
+        package['Source'] = args[:source] if args[:source]
+        if args[:destinations]
+            add_array_to_hash!(package, 'Destinations', args[:destinations])
+        else
+            add_array_to_hash!(package, 'Destinations', args[:to]) if args[:to]
+        end
         request('SendRawEmail', package)
       end
 
@@ -121,4 +141,4 @@ module AWS
     
     end
   end
-end
+end

data/lib/aws/ses/version.rb

@@ -3,7 +3,7 @@ module AWS
     module VERSION #:nodoc:
       MAJOR    = '0'
       MINOR    = '4'
-      TINY     = '1' 
+      TINY     = '2' 
       BETA     = Time.now.to_i.to_s
     end
     

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: aws-ses
 version: !ruby/object:Gem::Version 
-  hash: 13
+  hash: 11
   prerelease: 
   segments: 
   - 0
   - 4
-  - 1
-  version: 0.4.1
+  - 2
+  version: 0.4.2
 platform: ruby
 authors: 
 - Drew Blas
@@ -16,14 +16,12 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-02-09 00:00:00 -06:00
+date: 2011-03-11 00:00:00 -06:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
-  prerelease: false
-  name: xml-simple
   type: :runtime
-  version_requirements: &id001 !ruby/object:Gem::Requirement 
+  requirement: &id001 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ">="
@@ -32,12 +30,12 @@ dependencies:
         segments: 
         - 0
         version: "0"
-  requirement: *id001
-- !ruby/object:Gem::Dependency 
+  name: xml-simple
+  version_requirements: *id001
   prerelease: false
-  name: builder
+- !ruby/object:Gem::Dependency 
   type: :runtime
-  version_requirements: &id002 !ruby/object:Gem::Requirement 
+  requirement: &id002 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ">="
@@ -46,12 +44,12 @@ dependencies:
         segments: 
         - 0
         version: "0"
-  requirement: *id002
-- !ruby/object:Gem::Dependency 
+  name: builder
+  version_requirements: *id002
   prerelease: false
-  name: mime-types
+- !ruby/object:Gem::Dependency 
   type: :runtime
-  version_requirements: &id003 !ruby/object:Gem::Requirement 
+  requirement: &id003 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ">="
@@ -60,12 +58,12 @@ dependencies:
         segments: 
         - 0
         version: "0"
-  requirement: *id003
-- !ruby/object:Gem::Dependency 
+  name: mime-types
+  version_requirements: *id003
   prerelease: false
-  name: mail
+- !ruby/object:Gem::Dependency 
   type: :runtime
-  version_requirements: &id004 !ruby/object:Gem::Requirement 
+  requirement: &id004 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ~>
@@ -76,12 +74,12 @@ dependencies:
         - 2
         - 5
         version: 2.2.5
-  requirement: *id004
-- !ruby/object:Gem::Dependency 
+  name: mail
+  version_requirements: *id004
   prerelease: false
-  name: shoulda-context
+- !ruby/object:Gem::Dependency 
   type: :development
-  version_requirements: &id005 !ruby/object:Gem::Requirement 
+  requirement: &id005 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ">="
@@ -90,12 +88,12 @@ dependencies:
         segments: 
         - 0
         version: "0"
-  requirement: *id005
-- !ruby/object:Gem::Dependency 
+  name: shoulda-context
+  version_requirements: *id005
   prerelease: false
-  name: bundler
+- !ruby/object:Gem::Dependency 
   type: :development
-  version_requirements: &id006 !ruby/object:Gem::Requirement 
+  requirement: &id006 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ~>
@@ -106,12 +104,12 @@ dependencies:
         - 0
         - 0
         version: 1.0.0
-  requirement: *id006
-- !ruby/object:Gem::Dependency 
+  name: bundler
+  version_requirements: *id006
   prerelease: false
-  name: jeweler
+- !ruby/object:Gem::Dependency 
   type: :development
-  version_requirements: &id007 !ruby/object:Gem::Requirement 
+  requirement: &id007 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ~>
@@ -122,12 +120,12 @@ dependencies:
         - 5
         - 2
         version: 1.5.2
-  requirement: *id007
-- !ruby/object:Gem::Dependency 
+  name: jeweler
+  version_requirements: *id007
   prerelease: false
-  name: rcov
+- !ruby/object:Gem::Dependency 
   type: :development
-  version_requirements: &id008 !ruby/object:Gem::Requirement 
+  requirement: &id008 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ">="
@@ -136,12 +134,12 @@ dependencies:
         segments: 
         - 0
         version: "0"
-  requirement: *id008
-- !ruby/object:Gem::Dependency 
+  name: rcov
+  version_requirements: *id008
   prerelease: false
-  name: flexmock
+- !ruby/object:Gem::Dependency 
   type: :development
-  version_requirements: &id009 !ruby/object:Gem::Requirement 
+  requirement: &id009 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ~>
@@ -152,12 +150,12 @@ dependencies:
         - 8
         - 11
         version: 0.8.11
-  requirement: *id009
-- !ruby/object:Gem::Dependency 
+  name: flexmock
+  version_requirements: *id009
   prerelease: false
-  name: xml-simple
+- !ruby/object:Gem::Dependency 
   type: :runtime
-  version_requirements: &id010 !ruby/object:Gem::Requirement 
+  requirement: &id010 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ">="
@@ -166,12 +164,12 @@ dependencies:
         segments: 
         - 0
         version: "0"
-  requirement: *id010
-- !ruby/object:Gem::Dependency 
+  name: xml-simple
+  version_requirements: *id010
   prerelease: false
-  name: builder
+- !ruby/object:Gem::Dependency 
   type: :runtime
-  version_requirements: &id011 !ruby/object:Gem::Requirement 
+  requirement: &id011 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ">="
@@ -180,12 +178,12 @@ dependencies:
         segments: 
         - 0
         version: "0"
-  requirement: *id011
-- !ruby/object:Gem::Dependency 
+  name: builder
+  version_requirements: *id011
   prerelease: false
-  name: mime-types
+- !ruby/object:Gem::Dependency 
   type: :runtime
-  version_requirements: &id012 !ruby/object:Gem::Requirement 
+  requirement: &id012 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ">="
@@ -194,7 +192,9 @@ dependencies:
         segments: 
         - 0
         version: "0"
-  requirement: *id012
+  name: mime-types
+  version_requirements: *id012
+  prerelease: false
 description: Client library for Amazon's Simple Email Service's REST API
 email: drew.blas@gmail.com
 executables: []
@@ -266,7 +266,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: 
-rubygems_version: 1.4.2
+rubygems_version: 1.5.2
 signing_key: 
 specification_version: 3
 summary: Client library for Amazon's Simple Email Service's REST API